APPLE 
MACHINE LANGUAGE 
/ 


zn 


Learn machine language programming quickly and easily, 
using this unique and entertaining method—combines color, 
graphics, and sound with step-by-step, uncomplicated demonstrations. 


Apple 
Machine Language 


Don Inman Kurt Inman 


Reston Publishing Company, Inc. 
(6) А Prentice-Hall Company 


Reston, Virginia 


Library of Congress Cataloging in Publication Data 
Inman, Don. 
Apple machine language. 


Includes index. 
1. Apple computer—Programming. 2. Basic 


(Computer program language) |. Inman, Kurt, joint 
author. |l. Title. 
QA76.8.A66156 001.65'2 80-20083 


ISBN 0-8359-0231-5 
0-8359-0230-7 pbk. 


© 1981 by Reston Publishing Company, Inc. 
A Prentice-Hall Company 
Reston, Virginia 22090 


All rights reserved. No part of this book 
may be reproduced, in any way or by any means, 
without permission in writing from the publisher. 


10 9 


Printed in the United States 


Contents 


PREFACE vii 


Chapter 1 REVIEW OF APPLESOFT II BASIC 1 
Commands, 2 
Assignment Statements, 6 
Display Statements, 8 
Loop Statements and Subroutines, 11 
Graphic Statements, 13 
Relational Statements, 15 
Precedence of Mathematical and Logical Relationships, 15 
Strings and Functions, 16 
BASIC Statements of Special Importance, 17 
Exercises, 20 
Answers to Exercises, 21 


Chapter 2 CROSSING THE BRIDGE 22 


BOS Memory Use, 25 
A Simple BASIC Operating System, 29 
The Completed BASIC Operating System, 41 
Exercises, 44 
Answers to Exercises, 44 


Chapter 3 INSTRUCTION CODE FORMAT 46 


Number Systems, 47 
Accumulator, 53 


Instructions in Memory, 57- 

Use of the BASIC-M/L Operating System, 57 
Summary, 68 

Exercises, 70 

Answers to Exercises, 11 


lii 


Chapter 4 


Chapter 5 


Chapter 6 


Chapter 7 


Chapter 8 


SIMPLE GRAPHICS 72 
Plotting a Point on the Screen, 73 
Four-Corner Plot, 79 

Drawing a Horizontal Line, 83 
Drawing Vertical Lines, 86 
Drawing a Rectangle, 89 
Summary, 92 

Exercises, 93 

Answers to Exercises, 94 


DISPLAYING TEXT 95 
Displaying a Character, 95 

Discussion of the New Instructions, 99 
Running Through the Alphabet, 106 
Displaying ASCII Codes, 109 

Running the Program, 112 

Displaying More Than One Line, 113 
Summary, 120 

Exercises, 122 

Answers to Exercises, 124 


APPLE SOUNDS 125 

Modification to the BASIC Operating System, 127 
Description of the Tone Experiment Program, 128 
Executing the Program, 130 

How Sections 2 and 3 Work, 136 

Summary, 138 

Exercises, 140 

Answers to Exercises, 141 


MORE SOUNDS AND GRAPHICS 142 
Combining the Speaker and Video Display, 142 
Entering and Running the Program, 147 

Using the Keyboard to Play the Notes, 148 
Description of the Program, 151 

Entering and Running the Program, 155 
Summary, 156 | 

Exercises, 158 

Answers to Exercises, 159 


THE APPLE SYSTEM MONITOR 160 
The Processor Status Register, 167 

Subtraction, 172 

Summary, 176 

Exercises, 177 

Answers to Exercises, 178 


iv 


Chapter 9 MULTIPLE PRECISION AND 
NEGATIVE NUMBERS 179 

Two-Byte Addition, 179 
Two-Byte Subtraction, 184 
Negative Numbers, 186 
A Number Guessing Game, 189 
Summary, 200 
Exercises, 201 
Answers to Exercises, 202 


Chapter 10 MORE MONITOR MAGIC 203 
Hexadecimal Addition—Immediate Mode, 203 

Hexadecimal Subtraction, 206 
Decimal Arithmetic, 208 
Examining and Altering Registers, 217 
Summary, 223 
Exercises, 224 
Answers to Exercises, 225 


Chapter 11 | MINI-ASSEMBLER AND ADDRESSING MODES 227 


Using the Mini-Assembler, 228 
Indexed Addressing, 234 

Zero Page Indexing, 235 
Absolute Indexed Addressing, 240 
Indexed Indirect Addressing, 244 
Indirect Indexed Addressing, 251 
Summary, 255 
Exercises, 257 
Answers to Exercises, 258 


Chapter 12 PUTTING IT ALL TOGETHER 259 
8-Bit Multiplication, 259 
Multiplication Directly From BASIC, 265 
Multiplication Using the BASIC Operating System, 266 
Multiplication Using the System Monitor, 268 
Multiplication Using the Mini-Assembler, 269 
8-Bit Division, 271 
Summary, 276 
Exercises, 277 
Answers to Exercises, 279 


Appendix A-1 BASIC STATEMENTS 280 
A-2 MACHINE LANGUAGE INSTRUCTIONS 281 
A-3 BUILT-IN SUBROUTINES 282 


V 


A-4 
A-5 


Appendix B 


Appendix C-1 
C-2 
C-3 


Appendix D 


DISPLAY SYMBOLS 282 
PROGRAMS 283 


HEX EQUIVALENTS FOR 
DECIMAL NEGATIVES 284 


VIDEO MEMORY 285 
ASCII SCREEN CODES 287 


COLOR CODES FOR 
LOW RESOLUTION GRAPHICS 288 


6502 INSTRUCTION CODES 289 


INDEX 294 


Vi 


Preface 


The purpose of this book is to introduce Apple computer users, who have a 
knowledge of BASIC language, to machine language programming. The transi- 
tion from BASIC is made in small, easy steps. Color, graphics, and sound are 
used early in the book to make the demonstration programs interesting and 
action-packed. Each new instruction is explained, and the demonstration pro- 
grams are discussed step-by-step in functional sections. 

The reader first uses the BASIC statements POKE, PEEK, and CALL to 
enter and execute machine language programs from within a BASIC language 
program. A BASIC Operating System is then developed from which machine 
language programs can be entered and executed. 

The introduction from BASIC, a language the reader already knows, pro- 
vides a natural approach that leads to the use of the Apple System Monitor. The 
System Monitor allows the reader to enter, examine, and execute machine lan- 
guage programs directly. The time used by the computer to interpret BASIC 
statements is thus eliminated. 

The final step in the transition is to the Apple's Mini-Assembler, which re- 
lieves the programmer of many of the tedious details involved with direct ma- 
chine language programming. 

Approaching machine language through BASIC provides a means for the 
reader to use his or her previous knowledge as a stepping stone to explore a new 
area. 

You will proceed through this book in four definite stages. Machine lan- 
guage programs are entered and executed by four distinct methods. One method 
is introduced at each stage of the book. 


1. |BASIC| Introduced in Chap. 1. Machine language programs аге 
under full control of BASIC, using the instructions POKE, 


CALL, and PEEK. 


2. Introduced in Chap. 2. Machine language programs are con- 
trolled by a BASIC Operating System. 


Vii 


3. Introduced in Chap. 8. Machine language programs are 
hand-assembled and entered directly from the Apple Sys- 
tem Monitor. 


4. Introduced in Chap. 11. Machine language programs are 
assembled by the Apple Mini-Assembler. 


The А j , and logos appear in the table 


of contents and in the appropriate chapter headings where they are used. 
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Chapter 1 


Review of Applesoft || Basic 


Several assumptions are made in writing this book. The authors felt this to be 
necessary because of the numerous versions of Apple computers presently in 
use. 


1. You have made the necessary hardware connections. If not, see the reference 
manuals provided with your Apple computer. 


2. The authors have used a version of the Apple that has: 
a. Applesoft II BASIC on a plug-in ROM printed circuit card. 
b. A switch on the card to select either Applesoft II or Integer BASIC. 


3. You will read and use the Apple manuals pertinent to your particular ma- 
chine. 


4. You know how to switch back and forth between the programming languages 
available to you. 


The Apple computer can speak several languages. The prompt character 
indicates which language your Apple is currently ready to understand. The aster- 
isk (*) indicates that you are in the machine language mode. This language is 
always in the computer and does not have to be "loaded" (entered from an ex- 
ternal source) from a cassette or diskette. The machine language monitor that 
controls the use of this language is discussed in the latter part of this book (from 
Chap. 8 on). 


Asterisk When using 
prompt Machine Language 


Cursor 


If your Applesoft is on the plug-in ROM pc card, your Apple also contains 
a high-level English-oriented language called Integer BASIC* stored permanentlv 


*BASIC was developed at Dartmouth College by John Kemeny and Thomas Kurtz as 
an all-purpose computer language suitable for beginning programmers with diverse educa- 
tional backgrounds. А 


in its ROM memory. ROM, which is an abbreviation for Read Only Memory, can 
be “read” (used by your programs), but cannot be “written into” (changed by 
you). The prompt character for Integer BASIC is a right facing arrow (>). Inte- 
ger BASIC is not discussed in this book. For more information, see the Apple II 
BASIC Programming Manual (Apple product £A2L005X). 

Applesoft 1 is Apple's extended BASIC language. The prompt character of 
Applesoft II is a right square bracket (]). This extended BASIC is now available 
in three forms: 


1. The Apple II Plus System with the Autostart Monitor ROM 
2. The Applesoft plug-in interface card 
3. The Apple Language System 


The Apple II Plus System has Applesoft II BASIC in ROM. Therefore, the 
Apple Mini-Assembler, the Floating Point Package, and the SWEET-16 inter- 
preter (which are stored in the Integer BASIC ROMs) are not available on the 
Apple II Plus system. 

Since we will be using the Mini-Assembler later in the book, we will focus 
on the system containing the Applesoft 1 ROM card rather than the Apple 11 
Plus system. 


Right bracket APPLESOFT II 
prompt 
] 5 


Cursor 


This book is designed to provide a bridge over which the reader may cross 
from programming in BASIC to programming in the computer's native machine 
language. While the book assumes a background knowledge of Applesoft 11 
BASIC, a brief review of BASIC statements used by the Apple computer is pre- 
sented in this chapter. If you feel confident of your knowledge of Applesoft II 
BASIC, feel free to move on to Chap. 2. However, if your BASIC is rusty, spend 
some time reviewing the material here. 

Although this material is not a complete discussion of Applesoft capabil- 
ities, all those statements and commands necessary for understanding the re- 
maining chapters of.the book are given. An Apple computer with 16K of RAM, 
a tape recorder or disk drive, and Applesoft II BASIC are all that are necessary 
to perform the demonstrations and exercises presented. 


COMMANDS 

Certain fundamental commands are necessary in preparing, debugging, and 
executing a program. Those discussed here are NEW, LIST, RUN, TEXT, 
GRaphics, LOAD, SAVE, CONTinue, TRACE, and NOTRACE. 
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NEW 

25 

<) == LIST 
“вум 


COMMANDER 


! 


NEW — This erases any old program that may be in the computer’s memory. 
It not only deletes the current program, but also clears all variables that 


may have been set by this program. It is used before a new program is 
entered. 


Example: 

10 LET M=50 

20 PRINT M 

30 LET M = M+1 

40 IF M<60 THEN GOTO 20 
50 END 


]NEW -———7 When you type this and 
press the RETURN key. 


PRESTO! EVERYTHING IS GONE! 


LIST — This causes the current program to be displayed on the video screen. 
Several versions of this command are shown in the examples. All versions 
assume that you have a program in the computer. 


Examples: 


1. Type: LIST and press the RETURN key. 
The whole program will be displayed. If the program is very long, the 
display will scroll upwards after the screen is filled. 
2. Type: LIST 20,100 
Or 
LIST 20-100 and press the RETURN key. 
This will display lines 20 through 100 of the program. 
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3. Type: LIST -150 and press the RETURN key. 
This will display all lines from the beginning of the program through 
line 150. 


4. Type: LIST 150- and press the RETURN key. 
This will display all lines from line 150 through the end of the program. 


5. Type: LIST 150 and press the RETURN key. 
This will display only line 150. 


To stop the listing temporarily at some point, hold down the CTRL (con- 
trol) key and press the letter S. Use CTRL S again to resume the listing. 
This will allow you to examine parts of the desired listing. A listing is 
aborted by a CTRL C, but the listing cannot be continued from the point 
at which it is aborted unless you note where the listing was stopped and 
continue from that point with the LIST command. _ 
RUN — This causes the computer to RUN (or execute) the program that is cur- 
rently stored in its memory. All variables are cleared and execution begins 
at the lowest numbered line in the program (unless a beginning line num- 
ber follows the word RUN, as in Example 2). 


Examples: 


1. Type: RUN and press the RETURN key. 
The program is executed from the lowest line number. 


2. Type: RUN 200 and press the RETURN key. 
The program is executed beginning with line 200. 


TEXT — This command sets the video screen format to display a full screen of 
text with a maximum of 40 characters per line and 24 lines. This is the 
normal format used when Applesoft 1 BASIC is accessed. This command 
is used when returning from a Graphics mode to display a full screen of 
text. It can also be used as a statement within a program to change from 
Graphics to Text format. | 


Example: 
Type: TEXT and press RETURN 


GR — This command sets the low resolution graphics format for screen display. 
With this command, a 40 by 40 grid is available for graphics. The screen is 
cleared with a black background, and the cursor is moved to the beginning 
of a 4-line text window at the bottom of the screen. The color to be used 
for graphics is automatically set to black (COLOR = 0). Some other 
COLOR value must be given to display graphics (black on black doesn't 
show up too well). 


Example: 
Type: GR and press RETURN 


40 by 40 
graphics area 


Cursor 4 lines for text 


LOAD — This command causes the computer to read an Apple program from a 
cassette tape into the computer's memory. The user must have the re- 
corder ready (set to the beginning of the desired program and in the PLAY 
mode) before the LOAD command is given. A “beep” is sounded when the 
Apple has found the information on the tape. A second beep will sound 
when the program on tape has been successfully LOADed. The Applesoft 
prompt will appear on the screen at that time. A LOAD may only be 
interrupted by pressing the RESET key or turning off the power. 


Example: 


Ready your recorder, then 
Type: LOAD and press RETURN. 
When finished, the display will show: 


] LOAD ——— Indicates successfully 
] = LOADed program 


SAVE — This stores the program currently in the computer's memory on cas- 
sette tape. The user must press the RECORD and PLAY buttons on the 
tape recorder before SAVE is executed. Beeps signal the beginning and end 
of the SAVE procedure. 


Example: 


Ready your recorder, then 
Type: SAVE and press RETURN. 


CONT — If the execution of a program has been halted by a STOP, END, or 
CTRL C, this command causes execution to resume at the next instruction 
following the halt. Nothing is cleared. CONT cannot be used if you have 
(1) modified, added, or deleted any program line or (2) received an error 
message since stopping execution. 


Example: | 
Type: CONT and press RETURN 


TRACE — This is used in debugging programs. It causes line numbers to be dis- 
played on the screen as the lines are executed. You can then see if the pro- 
gram is performing the desired sequence of operations. The TRACE 
feature is turned off by the command NOTRACE. 


Example: 


Type: TRACE and press RETURN 
Then type RUN to see the sequence of line execution. 


NOTRACE — This turns off the TRACE feature discussed above. 


Example: 
Type: NOTRACE and press RETURN 
When the program is RUN again, no line numbers will be printed. 


ASSIGNMENT STATEMENTS 


There are several ways that data (both numeric and string) may be assigned 
to variables. Instructions used for this purpose in this section are LET, INPUT, 
READ, and GET. DATA and RESTORE instructions are also discussed ; they are 
used in conjunction with the READ instruction. 


LET — This statement may be used to assign values to variables. The word LET 
is optional, as seen in the example at lines 50 and 60. 


Examples: 

10 LET M=50 -— ——- Assign a numeric value to M 

20 FOR X=1TO9 

30 LET A$ = “APPLES” -—— —— Assign the string APPLES to A$ 
40 LET M = М+1 +—— Alter a variable's value 

50 B=1 The word LET does not have to 
60 B$ = " PER CARTON " каш be used. It is optional. 


70 PRINT M;A$,B;B$ 
80 NEXT X 


INPUT — This instruction is used to assign a value to a variable during execution 
of a program. When the computer reaches this instruction, it stops and 
waits for the user to type in the value to be assigned to the variable. 


Examples: 
50 INPUT A The execution of this statement dis- 
plays a question mark and waits for 
| a the user to type in the value and press 
RETURN. 
70 INPUT A,B,C More than one variable can be assigned 


by one INPUT statement. The values 
are typed in, separated by a comma. 


80 INPUT "PLEASE TYPE YOUR NAME"; C$ 
A message may be printed to tell you 
what INPUT is desired. The message is 
typed in quotes. The variable C$ calls 
for a string INPUT. A question mark is 
not printed with this format. 


PLEASE TYPE YOUR NAMEs 


90 INPUT A$ No message this time. Display will 


show a question mark when this in- 
78 struction is executed. 


100 INPUT "WHAT IS THE VALUE OF A?'5 A 
If you want a question mark when 
quotes are used in a message, include 
the question mark inside the quote. 


| WHAT IS THE VALUE OF A?m 


READ — This instructs the computer to READ a value from a DATA list and 
assign that value to a variable. The first time a READ is executed, the first 
item in the first DATA list will be used. The second time, the second item 
from the DATA list will be used, etc. (See DATA for example.) 


DATA — This lets you store DATA inside your program. The items will be read 
sequentially. More than one DATA statement may be used in a program. 
Items will be READ from the first DATA statement until all its items have 
been READ. Then items will be read from the next DATA statement, etc. 


Example: 

110 FOR X721 TO 10 

120 READY -——— —— Reads DATA in this order: 

130 NEXT X 10 

140 DATA 10,30,20,40,50 30 

150 DATA 60,80,90,70,100 20 

| 40 

50 
60 
80 
90 
70 
100 


RESTORE — This causes the next READ statement executed to start from the 
first item in the first DATA list. 


Example: 


100 FOR Х = 1ТО 5 

110 READ Y: PRINT Y -—— Reads and prints 

120 NEXT X 10,30,50,20,40 

130 RESTORE -———— Go back to start of DATA list 

140 FOR Z-1 TO 10 

150 READ М: PRINT W ~—— Reads and prints 

160 NEXT Z | 10,30,50,20,40,60,80,100,70,90 
170 DATA 10,30,50,20,40 

180 DATA 60,80,100,70,90 


d E 


60 80 100 70 90 


RESTORE 


GET — This gets (or reads) a single character from the keyboard. The computer 
waits for a key to be pressed, as in an INPUT statement. The character js 
not displayed and does not require that the RETURN key be pressed. 


Example: 


200 GET H$ 

210 IF H$ = “Y” THEN GOTO 500 

220 GOTO 100 

Line 200 would wait for a key to be pressed. The typed character would 
be stored as the variable H$. If the typed character is a Y, line 500 would 
be executed after line 210. If not, line 220 would return execution to line 
100. 


DISPLAY STATEMENTS 


The PRINT statement is used in many forms to display data on the video 
screen. The display can also be changed from white on black to black on white 
by the INVERSE statement. You can also alternate these two formats by using 
the FLASH statement. The NORMAL statement returns the display to the 
normal white-on-black format. HOME is used to clear the video screen. SPC is 
used to format print statements. 


Examples: 


320 PRINT | The word PRINT used by itself 
causes a line feed and return to be 


: 310 PRINT A 


300А=5:В=6 
310 PRINT A 
320 PRINT 

330 PRINT B 


executed on the screen. (See line 320 
in example below .) 


Prints the value of A and causes a line 
feed and return. (See line 310 in the 
example below.) 


Display when these lines are executed: 


5 -—————— From PRINT A 
-——————— Blank line caused by PRINT 
6 -— ———- From PRINT B 


400 PRINT “А STRING" 


| A STRING 
=» 410 PRINT А,В 


6 CERE 
5 6 


oxy” PRINT A;B 
$ © 


430 PRINT A$;A 


440 PRINT A$;A, 
450 PRINT B$;B 


Prints the words A STRING, and 
moves to the next line. 


IF A = 5 and В = 6, this will cause the 
two values to be printed on the same 
line spaced far apart. 


This time the values will be printed on 
the same line but close together. 


If A$=“A=” and A=5, this will print 
the string, A7, and the value of A. 


If А$=“А= ” and B$=“B= " with A=5 
and B=6, the comma keeps the display 
on the same line. The result of these 
two lines will be as shown. 


500 PRINT TAB(10)A$;A The TAB function moves the printed 
| display over to the stated print posi- 
tion. (Print positions on a given line 


are 1 through 40.) 
| = 5 
10th TAM". 


position 


FLASH — This statement sets the video mode to flashing. The output is alter- 
nately shown as white on black and black on white. Use the NORMAL 
statement to return to a nonflashing white-on-black mode. 


Example: 
70 FLASH 


80 PRINT “FLASHING” . «—— The word FLASHING will flash back 
and forth. 


INVERSE — This sets the video mode so that the computer's output is displayed 
as black letters on a white background. 


Example: 


100 INVERSE | 
100 PRINT “INVERTED” -—— The word INVERTED will appear in 
black letters on a white background. 


NORMAL — This sets the video mode back to the usual display of white letters 
on a black background with no flashing and no inversion. 


Example: 

70 FLASH 

80 PRINT “FLASHING” |. «——— The word FLASHING will FLASH 
and remain flashing 

100 INVERSE 

110 PRINT “INVERTED” ~—— The word INVERTED will appear as 
black on white and will stay that way 

120 NORMAL 

130 PRINT "NORMAL" -«———— The word NORMAL and all future 
printed material will be in the normal 
mode (unless changed by FLASH or 
INVERSE again). 


HOME — This statement moves the cursor to the upper left screen position 
within the text window. It also clears all text within the text window. 
HOME may be used in the TEXT or GRaphics mode. 
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SPC(X) — This provides for X number of blank spaces to be inserted between 


the last item printed and the next item printed if semicolons precede and 
follow the SPC statement. It is on/y used within a PRINT statement. 


Example: 


400 PRINT A; SPC(2); B 
If A = 768 and B = 5, line 400 (when executed) would display: 


| 768 \ 
A is Then 2 ‘Then В is 
printed spaces printed 


LOOP STATEMENTS AND SUBROUTINES 


Portions of a program may be repeated by several BASIC statements such 


as GOTO, ON. . .GOTO, IF-THEN, and FOR-NEXT. Subroutines may be per- 
formed by GOSUB and RETURN. 


GOTO — This statement causes the program to branch from the line where the 


ON. 


GOTO is located to the line that is specified following the word GOTO. 


Examples: | 

30 GOTO 200 -— All lines between 30 and 200 are 
skipped. 

70 A= 73 -— The program branches from line 210 

80 PRINT A to line 70. 

90 END : 

200 PRINT “THE END" 

210 GOTO 70 

. . GOTO 100,200,300 . . . — This statement evaluates the arithmetic ex- 


pression following the word ON. It then branches to the line number 
(100,200,300, . . . ) corresponding to the result of the evaluation. 100, 


200,300, etc., must be valid line numbers in the program. 
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Example: 


150 ON INT(B/100) GOTO 200,300,400 
160 PRINT "INT(B/100) is 0 or 23" 


The expression INT(B/100) is evaluated. Then, 

a. If the value = 1, line 200 will be executed following line 150. 

b. If the value - 2, line 300 will be executed following line 150. 

c. If the value = 3, line 400 will be executed following line 150. 

d. If the value = 0 or is 23, line 160 will be executed following line 150. 


IF-THEN — If the condition stated between the words IF and THEN is true, 
then the instruction following the word THEN is executed. Otherwise, the 
instruction following the word THEN is ignored. 


Examples: 

200 IF X25 THEN GOTO 400 -— Branches to line 400 if, and only if, 
X>5 

210 IF X <=5 THEN PRINT “X IS NOT >5” 

220 X = X1 W If X«&5, then the words X IS NOT 
25 are printed, then line 220 is 
executed. 


‘otherwise, the words are not printed. 
Line 220 is then executed. 


FOR-NEXT — This is a combination of two statements. It allows you to "loop 
through" a set of statements between the FOR statement and the NEXT 
statement a specified number of times. 


Examples: 


| к MM 
20 FOR X =1 TO 25 Upper limit 
30 PLOT X,10 <~—————Plots 25 points from 1,10 through 
40 NEXT X 


20 FOR N = -10 TO 10 STEP 2 <—Increase М in steps of 2 
30 PRINT N <— Prints even integers from -10 through 
40 NEXT N 10 


GOSUB — This causes the program to branch to a subroutine which you have 
written at the specified line number. When the subroutine is completed, a 
RETURN statement in the subroutine will return to execution of the pro- 
gram at the line following the most recently used GOSUB statement. 
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Example: 
200 GOSUB 2000 From here... 


2000 FOR X = 1 TO 3000-4 to here 
2010 NEXT X 
2020 RETURN 


Then back to... 


RETURN - This statement is used at the end of a subroutine to return to the 
statement immediately following the most recently executed GOSUB. 
(See example above.) 


GRAPHIC STATEMENTS 


Graphic statements shown here are GRaphics, COLOR, PLOT, HLIN, VLIN, 
PDL, and TEXT. The Graphics mode presents a display that is quite different 
from the TEXT mode. You must be able to change from one mode to the other. 


GR — This statement sets the low resolution Graphics mode. (See GR under 
"Commands" section.) 


COLOR — This sets the color for plotting in the low resolution Graphics mode. 
Color is set to black (0) by the GR statement. The color values used are: 


O black 4 dark green 8 brown 12 green 
1 magenta 5 grey 9 orange 13 yellow 
2 darkblue 6 medium blue 10 grey 14 aqua 
3 purple 7 light blue 11 pink 15 white 


PLOT — This turns on one of the 40 by 40 low resolution dots in the graphics 
area at the column and row specified. The dot will be of the color selected 
by the COLOR statement. The three statements are used together. 


Example: 
10 GR -——- Set Graphics mode 
( = | 20 COLOR = 9 <— Use orange 
30 PLOT 20,30 -«—— Plot a point in column 20, row 30 
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HLIN — This statement is used to draw a horizontal line. Included in the state- 
ment are the beginning and ending columns, as well as the row where the 
line is to be drawn. 


Example: 
10 GR 
20 COLOR = 4 -— — —— Dark green color 


30 HLIN 10,20 AT 30 «—— — — —- Draw at row 30 
тїтїп \ _ End at column 20 
Start at column 10 


VLIN — This command is used to draw a vertical line from one row to another 
at the specified column. 


Example: 


10GR 
20 COLOR = 11 4«——— —— —— Pink color 


30 VLIN 6,14 AT 12 «—— — —— Draw in column 12 
N ee e at row 14 


Start at row 6 


PDL(0) or PDL(1) — This reads the current value of one of the game controls 
(a number from 0 through 255). The paddles (game controls) can be used 
to plot points in the low resolution Graphics mode, as shown below. (They 
can also be used with high resolution graphics.) 


Example: 

10GR 

20 COLOR = 14 

30 PLOT PDL(0)/7, PDL(1)/7 
Row 
Column 


TEXT — This statement is used to return to the TEXT mode following the use 
of high or low resolution graphics. 


Example: 


10 GR 

20 COLOR = 14 

30 VLIN 6,14 AT 12 

40 FOR X = 1 TO 3000 == Delay to view the color Баг 
50 NEXT X 

60 TEXT ~— Return to the TEXT mode 
70 HOME -«—— —— —— —— Home the cursor 
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| For a few seconds you see the aqua- 
| colored bar 


] E V  ——————— Then the screen returns to the TEXT 
mode and the cursor appears at the 
upper left corner. 


RELATIONAL STATEMENTS 


Two values may be compared by using one of several relational statements. 
The result of this comparison may be used by the computer to “make a de- 
cision" as to what action to perform next. 


MATHEMATICAL RELATIONSHIPS 


= is equal to 

> is greater than 

< is less than 

>= is greater than or equal to 
<= [6 less than or equal to 

# іѕ not equal to 


LOGICAL RELATIONSHIPS 


AND true if both conditions are true; otherwise false 
OR true if either or both conditions are true; otherwise false 
NOT Negation of the expression 

Examples: 


200 IF A>5 THEN GOTO 340 
300 IF A#B THEN PRINT “А IS NOT EQUAL TO B" 
400 IF A=5 AND B>=6 THEN C-A*B 


PRECEDENCE OF MATHEMATICAL AND LOGICAL 
RELATIONSHIPS 


The computer evaluates expressions by performing operations in a specific 
order. The order in which it performs these operations is in accordance with the 
following list. Their order of precedence is from the top downward. 
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Order Operation Function 


1. () Evaluate expression in parentheses 
2. NOT Negate 
3. ^ Raise to a power (exponentiate) 
4. *, Multiply or divide (left to right) 
5. +,- Add or subtract (left to right) 
6. =, >, <, >=, <=, # Сотраге 
7. AND AND two expressions 
8. OR OR two expressions 


STRINGS AND FUNCTIONS 


Several statements are used to manipulate strings. We will define only 
those which will be used in this book. They are ASC, CHR$, and LEFT$. Several 
intrinsic functions are also available, but we will only use the INTeger function. 


ASC — This command returns (or supplies) the decimal ASCII code for the first 
character in the string which is enclosed in parentheses following the let- 
ters ASC. 


Example: 
100 PRINT ASC(““YES”) aa print 89 (the ASCII code for 
the letter Y) 


190 GET H$ ~<«—would get a single character 
200 IF ASC(H$)<60 THEN GOTO 100 


2103 If the ASCII code for the character 
typed is «60, then go to line 100. 
Otherwise, line 210 


CHR$ — This returns (or supplies) the ASCII character that corresponds to the 
value given in parentheses. This value must be between 0 and 255, in- 


Clusive. 

Example: 

300 H= 14 If H = the decimal number 14, 

310 PRINT CHR$(H+55) then Н+55 = 69. The character 


whose ASCII code is 69 is the letter 
E. The letter E would be printed. 


LEFT$ — Returns (or supplies) the specified number of leftmost characters in 
the string enclosed in parentheses. If no number is specified, it returns 
only the leftmost character in the string. 
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Examples: 
200 PRINT LEFT$(“YESTERDAY”, 3) 


would print: YES (the 3 leftmost 
characters of YESTERDAY) 


250 INPUT H$ 


260 IF LEFT$(H$,1) = “Y” THEN GOTO 100 
270... If the leftmost character of the string 


input for H$ is a Y, then GOTO line 
100. If not, go on to line 270 


INT — The INTeger function returns the largest integer less than or equal to the 
expression in parentheses following the letters INT. 


Examples: 
100 X = INT (A/3) 
If A=5, A/3 = 1.66667 and INT(A/3) = 1 
If A= 1, A/3 = 0.333333 and INT(A/3) =0 
If A= 15, A/3 = 5 and INT(A/3) = 5 
If A = -5, A/3 = -1.66667 and INT(A/3) = -2 


BASIC STATEMENTS OF SPECIAL IMPORTANCE 


There are three instructions that you will be using over and over again to 
establish the bridge between BASIC and the machine language programs that 
you will be creating. These instructions are POKE, PEEK, and CALL. 

In BASIC, the line numbers serve as a reference for the computer. In- 
dividual statements are found and executed according to the line number associ- 
ated with a given statement. 

Machine language instructions are executed according to their placement 
in memory. There are no line numbers. Execution begins at a memory location 
which must be specified. Then the instructions are normally executed in the 
order that they appear in memory. 

The BASIC Operating System (described in Chap. 2) is used to put the 
machine language instructions and data into the correct memory locations to be 
used by the machine language program. This is done primarily by the following 
BASIC instructions. 


POKE address, data Where address is the decimal address 
of the memory location where the 


data is to be placed. 


Since POKE is a BASIC instruction, the values for address and data must 
be given as decimal values. 
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Examples: 


100 POKE 768,169 POKE the value 169 into memory | 
location 768 


POKE 


Memory Address value POKEd 


110 POKE 769,19 POKE the value 19 into memory loca- 


p tion 769 
[19 | 


769 


We now have: 


768 169 
769 19 


меги еен POKEd 
memory locations into memory 


Each machine language instruction and each data value used in the ma- 
chine language program will be entered from the BASIC Operating System by a 
POKE instruction. 

Once the machine language program and data have been entered by BASIC 
POKE statements, control must be passed from BASIC to the machine language 
program. This is done by the statement: 


CALL address 


CALLs for thé execution The decimal ad- 
of a machine language dress where the 
program (or subroutine) machine language 


program begins 


Example: 


CALL 768 -—— This would cause the computer 
to execute the machine lan- 
guage program that begins at 
memory location 768. 
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A third BASIC instruction that you will frequently use allows you to 
examine the content of a specified memory location. You can PEEK at a mem- 
ory location with the instruction: 


Parentheses 
PEEK (address) 


It says, "Show me what is in PEEK into this memory location 
the specified memory location." 
EET 


`, 
If you want to see what you PEEKed at, use the PRINT statement. 


Example: 
900 PRINT PEEK (768) 


This statement would cause the value contained in memory location 768 
to be displayed on the video screen. 


768 169 If 169 is in memory 768 and we ex- 
ecuted the PRINT PEEK instruction in 
the Immediate mode, we would see 
this on the display. 


]PRINT PEEK (768) 
169 


— ____ e 
]= The content of 768 is displayed 


The PEEK statement can be used to examine the machine language pro- 
gram itself, or it can be used to display the results of a machine language pro- 
gram that has been placed in a given memory location. 

These three statements (POKE, CALL, and PEEK) will be used repeatedly 
to establish a link between BASIC and machine language. The machine language 
is POKEd into memory by BASIC. It is then executed by the CALL statement 
from BASIC. The PEEK statement of BASIC can be used to look at the results 
of a machine language program or at the program itself. 

You can see that you will by relying heavily on these three BASIC state- 
ments. If a solid connection is to be made between BASIC and machine lan- 
guage, the three building block statements must be understood. You will see 
their use again in Chap. 2 when the BASIC Operating System is discussed. 
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EXERCISES 


. Tell what function each of the following commands performs. 
a. NEW 


b. LIST 


c. GR 


. The TRACE command causes line numbers to be displayed as a program is 
executed. What command turns off the TRACE feature? 


. Name three BASIC statements used to assign values to variables. 
a. 
b. 
С; 


. If you are currently using low resolution graphics and want to return to the 
Text Display Mode with the cursor in the upper left corner of the screen, 
what two commands should be entered? 

a. 

b. 


. Some of the operations shown below are in the wrong order of precedence. 
Rearrange them correctly according to their precedence, 


. Fill in the values in the correct memory boxes as performed by the following 
statements. 


100 POKE 768,19 
110 POKE 770,14 
120 POKE 772,18 
130 POKE 771,15 
140 POKE 769,16 


7. What will be displayed on the screen when the instructions of exercise 6 plus 
the following struction have been executed? 


150 PRINT PEEK (772) 


—— 
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. If a machine language program has been POKEd into memory and you desire 
to execute that program from BASIC, what BASIC statement could you use? 
160 


ANSWERS TO EXERCISES 


. а. NEW—Erases any old program and clears all variables 
b. LIST — Displays the current program on the video screen 
c. GR — Sets the screen display to the low resolution graphics format 


2. NOTRACE 


a. LET A = 5 (or just plain A75) 
. INPUT A 
. READ A 


8. 160 CALL 768 
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Chapter 2 


Crossing the Bridge 


When you communicate with the computer in BASIC, you are talking 
through an interpreter. Each program line must be examined in detail by the 
interpreter and translated into a code which the computer can understand. It is 
easy for you to write programs in BASIC, but it is a “foreign” language to the 
computer. The computer cannot understand a single simple BASIC statement. 
BASIC words and statements must be translated into binary number codes that 
have a precise meaning to the computer. These number codes are "words" that 
the computer can understand. They are the language of the computer, called 
machine language. Instructions must be in machine language code before the 
computer can understand them. 


а — 


COBRE, 
—> | COMPUTER 


INTERPRETER 
Enter BASIC Translate to Take action 
here machine language 


Once the BASIC statements have been interpreted, the computer acts on 
them. Its actions and the results it obtains must be translated once more into a 
form which BASIC can use and which you will be able to understand easily. 


Lo ;; a i ey 
COMPUTER | | —> |MAGIC BLACK) |, | рео 
BOX 
Action and Translated to a Output 
results in form that you and 


machine language — BASIC can "read" 
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Translating BASIC is a time-consuming chore for the interpreter, and it is 
wasteful of computer time. In addition, the BASIC language may not be able to 
handle everything that you might want the computer to do. 

Although machine language programming may be a more time-consuming 
and detailed task for you than programming in BASIC, it brings you into much 
closer contact with the computer. When you speak to the computer in machine 
language, you are talking to it directly. You will get quick responses and will 
gain a better understanding of your computer's “personality,” its full capabil- 
ities, and also its shortcomings. You will find that the computer speaks and 
understands a very limited, formal language. Each word is the same length and 
follows a rigid format. But its rules of form and syntax are much simpler than 
those of the English language. 

The machine language words can be broken down into eight bits (binary 
digits) that have only two possible states (or conditions). These tiny p are 
much like a light that is either on or off. 


ON ON QM 
ZL S 
OFF OFF 

OFF ON 


The computer interprets these bits as being one of two numeric symbols, 
0 or 1. The pattern of 1's and O's make a meaningful word, or a complete idea, 
to the computer. Therefore, we need to learn these words if we are to communi- 
cate directly with it. 


ML 
f: 
OFF ON 


An example of a pattern of 8 computer bits (a pattern with a size and 
shape that the computer can understand) is shown. 


0101101 1 


OFF OFF OFF 


The computer would recognize this pattern as a unique number code and 
would respond by taking a specific action or using the number as a specific 
piece of data. 
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Since machine language instructions are merely numbers that are placed 
in the computer's memory, we can use BASIC to perform this operation. The 
BASIC instruction: 


POKE address, data 


will store the given data into the memory location whose address is given. (See 
Chap. 1 for a review of this instruction.) 


Example: 

POKE 768,173 
Y Data value 173 is POKEd 

Data value is POKEd into 

memory location 768 


The data given in the POKE statement must be in the range of O through 
255, due to the nature of the computer's memory locations. Larger numbers will 
take up more than one memory location. If you try to POKE a number larger 
than 255 into memory, the computer will not accept the POKE. However, it 
won't POKE you back. Instead it will merely respond with an ILLEGAL QUAN- 
TITY ERROR. 


Example: 


Too big 


POKE 769256. o 


?|ILLEGAL QUANTITY ERROR 
]= 


It is important that you be careful where you POKE values. You may 
destroy essential values or instructions if you POKE into the wrong memory 
location. 

APPLESOFT II also has an instruction that will let you display the deci- 
mal value of the contents of a given memory location. It is: 


PEEK (address) 


To display the value in a given address, you could use the statement 200 PRINT 
PEEK(768). The computer would print the decimal value (0 through 255) that 
was contained in the memory location whose address is 768. 

So, you see, the Apple will let you POKE values into its memory, and it 
will let you PEEK at values that are already in its memory. You should spend 
some time experimenting with these two instructions in the Immediate Execu- 
tion mode. Try the following examples and others of your own. 
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Examples: 


First POKE Ж 


] POKE 768,173 
] POKE 769,25 
] POKE 770,3 


]^ 


Then PEEK 7-5 “7s 


ug SEIT, 


]POKE 768,173 
] POKE 769,25 
] POKE 770,3 

] PRINT PEEK(768) You see, the value 173 is in memory 


173 ee NND cd location 768 
]PRINT PEEK(769) / And the value 25 is in memory loca- 
25 tion 769 


]PRINT PEEK(770) And the value 3 is in memory location 
3 770 
]* 


The decimal values that can be used for the address in the POKE and 
PEEK statements depend on the memory capacity of your computer. 


MEMORY USE 


Many memory addresses cannot be used for machine language programs, 
as they contain information necessary for the Apple's operating system. The 
operating system might be compared to an airport traffic controller who directs 
the flow of traffic in and out of the airport. The operating system directs the flow 
of actions taken by the computer. A POKE into the operating system's memory 
locations might alter the operation of the system or the operation of your 
BASIC program. 

In addition to the Apple's operating system, you will be using the BASIC 
Operating System that will be discussed in this chapter. It is written in BASIC, 
and will be stored in the section of memory that is reserved for BASIC programs 
(see Memory Map below). It will control the input, revisions, and operation of 
the machine language programs that you will be using. 

Nor can data be successfully stored at addresses that contain Monitor 
ROMS, APPLESOFT ROMS, or unused Input/Output ports. The ROMs are 
Read Only Memories from which information can be read, but into which you 
cannot put information. They already contain information that is protected 
(cannot be changed by a program or immediate mode input). 

A memory map follows for the Applesoft firmware version of the Apple 
computer. 
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MEMORY MAP 
APPLESOFT IN FIRMWARE (ROM) 


Address | Function 
00000-00511 Program workspace — not for user 
00512-00767 Keyboard character buffer 
*00768-01023 Free to user for short machine language programs 
01024-02047 Screen Display area 


02048-XXXXX User area for BASIC programs and variables. XXXXX is de- 
termined by the maximum amount of RAM memory in- 
stalled in your machine. 
16K installed - XXXXX = 16383 
32K installed - XXXXX = 32767 
64K installed - XXXXX = 49151 


08192-16383 Used by high resolution graphics (page 1) 
16384-24575 Used by high resolution graphics (page 2) 
49152-53247 Hardware 1/О addresses 
53248-63487 Applesoft Interpreter (if switch set for Applesoft BASIC) 
53248-57343 ROM Area (1f switch set for Integer 
57344-63487 | [Ami Integer BASIC and | BASIC) 

Mini-Assembler 


64488-65535 Apple System Monitor 


*This is the area that you will be using for your machine language programs. 


Note:If you have Applesoft on diskette, see your Disk Operating System In- 
structional and Reference Manual (Apple Product #A2L0012) for a mem- 
ory map. 


The area that will be used for your machine language programs has been 
marked with an asterisk on each memory map. This area, from memory address 
768 through address 1023, is the same for both Applesoft versions. It can be 
used safely for most, if not all, of your machine language programs. If you need 
more space when your programs get longer, we can place them in the area nor- 
mally reserved for BASIC programs. 

We will use the program below to demonstrate the method of using BASIC 
to POKE a machine language program into memory. The data in the POKE state- 
ments are the elements of the machine language program. We will also PEEK to 
make sure that the program was correctly POKEd in at the right addresses. 
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POKE AND PEEK DEMONSTRATION 


100 REM * CLEAR THE SCREEN * 
110 HOME 


200 REM * POKE MACHINE LANGUAGE PROGRAM * 
210 POKE 768,169 

220 POKE 769,19 

230 POKE 770,141 

240 POKE 771,37 

250 POKE 772,3 

260 POKE 773,96 


300 REM * PEEK AT THE PROGRAM * 
310 FOR X = 768 TO 773 

320 PRINT PEEK(X) 

330 NEXT X 


Now if you RUN this BASIC program, the values POKEd into memory 
will be displayed. 


Yes, the machine language program has been POKEd into the correct 
memory locations by the BASIC program. By using just two BASIC instructions, 
you have the tools necessary to enter machine language programs (with POKE) 
and to look at the machine language program (with PEEK). However, we also 
need a method of executing the machine language program after it has been 
entered. 

The CALL instruction causes the computer to execute the machine lan- 
guage program beginning at a specified address. The address to use with the 
machine language program that you have just entered is 768. We would execute 
the program by using the statement: 


410 CALL 768 
The CALL statement is used to execute a machine language program that 
is a subroutine of a BASIC program. A GOSUB statement executes a BASIC sub- 


routine from a BASIC program; a CALL statement executes a machine language 
subroutine from a BASIC program. 
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We'll add the CALL statement to our program so that we can execute the 
machine language subroutine. We'll also add a PEEK statement to look at the 
results of the machine language program to make sure that it executed correctly. 

The last instruction executed in the machine language program must be a 
RETURN FROM SUBROUTINE (RTS). This is a machine language instruction 
that performs the same function for a machine language subroutine as the 
RETURN statement in BASIC does for a subroutine in BASIC. It returns con- 
trol to the BASIC program from which the machine language program was 
CALLed. 

Don't worry now about the machine language instructions being used in 
the program. Machine language codes will be introduced slowly starting in Chap. 
3. For now, an explanation of each section of the program is given to the right 
of the machine codes. Our completed program looks like this. 


POKE and PEEK, THEN PEEK AGAIN 


С) 100 КЕМ * CLEAR THE SCREEN * 
110 HOME 


200 REM * POKE MACHINE LANGUAGE PROGRAM * 


210 POKE 768,169 Loads the value 19 
220 POKE 769,19 
E 230 POKE 770,141 Store it in memory 


240 POKE 771,37 
250 POKE 772,3 
260 POKE 773,96 Return from subroutine 


300 REM * PEEK AT THE PROGRAM * 
^ ^ 310 FOR X = 768 TO 773 
Ce CP 320 PRINT PEEK(X) 
330 NEXT X 


Z 400 REM * EXECUTE THE PROGRAM * 
б Е|  410CALL 768 


eU 500 REM * LOOK INTO MEMORY FOR RESULT * 
19 C6  510PRINT: PRINT PEEK(805) 


We stored the 19 here. 
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When the program is run, this is what you'll see: 


-———— — Peeking at the program now (caused 
by lines 310-330) 


Sis 


Frys 


19 Yes, the 19 was stored in the correct 
location (executed by line 410 and 
iL memory PEEKed at by line 510). 
ZS 
C» [Sos] 


When the program is RUN, you do not see the machine language instruc- 
tions being POKEd in by statements 210-260. The results of the PEEKs per- 
formed by the FOR-NEXT loop (lines 310-330) are seen on the screen: 


169 These are machine language codes and data values 
19 which were POKEd in by lines 210-260 and 

141 PRINTed by the statement at line 320 in the 

37 FOR-NEXT loop. 

3 
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After the data has been PEEKed at, line 410 causes execution of the machine 
language program. When the computer returns to the BASIC program (caused by 
the last instruction in the machine language program), line 510 PRINTS the value 
19, thus assuring us that the data has been placed in the memory location that 
we requested. 


A SIMPLE BASIC OPERATING SYSTEM 


Based on the BASIC instructions just used, we'll soon build a simple 
BASIC program that can accept, run, and read the results of a machine language 
program. It will lack many features that are desirable for more sophisticated pro- 
gramming, but it will be sufficient for our purposes. 

It is a BASIC language program, but you may use it to enter each machine 
language program that you encounter in the rest of this book. You may also use 
it to examine the machine language programs for errors once they have been 
entered. You will use it to execute the machine language programs by using the 
CALL statement at the appropriate time. You can even use the BASIC program 
to examine the results of the machine language program that it creates. 
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The BASIC program will be used for so many things that we have decided 
to call it an Operating System. It is the operator and is in control of all the ac- 
tions that will be taken by the computer once it has been entered and run. Since 
it is written in BASIC, we have given it the full name of: BASIC Operating Sys- 
tem (Operating System for short). 

Keep in mind that the Operating System is written in BASIC, so it under- 
stands (or uses) BASIC statements and decimal numbers. However, as we stated 
before, the computer can only understand machine language instructions that 
are coded as binary numbers. In fact, most standard machine language references 
list the machine language codes as hexadecimal numbers. These strange hexadeci- 
mal numbers will be explained in Chap. 3, where you will be introduced to ma- 
chine language instructions. 

Here is our dilemma: 

1. References list machine language codes as 
hexadecimal numbers. 


2. The computer only understands the 
codes as binary numbers. 


3. The BASIC interpreter must receive 
decimal numbers, which it then converts 
to binary numbers for the computer's 
use. 

We could ask you to convert every hexadecimal machine language code to 

a decimal value for the BASIC interpreter to use. This conversion is a tedious 

and time-consuming chore. The computer could do the conversion much faster 

than a human if it was provided with a program to make the conversion. So, we 
will include this conversion as part of the BASIC Operating System program. 

Come along with us as we design the BASIC Operating System that will 
form a bridge to take you from BASIC to machine language programming. 


TaN 


as BASIC OPERATING SYSTEM [—.. MACHINE 


LANGUAGE 


BASIC 


We will now begin the construction of our Operating System. Each func- 
tional section will be explained. The short machine language program given 
previously will be used to show how each section of the Operating System 
works. Here is a brief description of the Operating System by sections. 
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FIRST 
Input the preliminary information 


SECOND 


Enter machine language program and 
convert hexadecimal data to decimal 


THIRD 


Print the program and check for 
corrections 


FOURTH 


Check again for additional changes 


FIFTH 


Execute the machine language 
program; then return to BASIC 


SIXTH 


Subroutines used by the Operating 
System 


First [| 


We must have some vital information about the machine language program 
to be used. We need to know its starting address in memory, and we need to 
know how long the program will be (how many memory locations it will use). 
In computer terminology, each memory location will hold one byte of informa- 
tion. A byte is made up of 8 bits (binary digits). Bits were discussed briefly 
earlier in this chapter, and both bytes and bits will be discussed more thoroughly 
in Chap. 3. Here is how we get the information for each memory location. 


SECTION 1 
100 REM * GET MACHINE LANGUAGE INFORMATION * 
110 HOME 
120 INPUT "STARTING ADDRESS FOR M/L-?"; S both inputs 
130 INPUT “HOW MANY BYTES?" 5 B in decimal 
140 INPUT “PRESS RETURN TO ENTER PROGRAM"; A$ 
150А=$ 
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Line 110 clears the screen. You input the starting address at line 120. (We 
will be using 768 as our starting address.) Line 130 asks for the number of bytes. 
(The program we will use has 6 bytes.) The starting address is assigned to the 
variable S in line 120. The number of bytes is assigned to the variable B in line 
130. The computer waits at line 140 for you to gather your courage before 
plunging into the program. After you press the RETURN key, the variable A 
is assigned the same value that S was assigned. This is done so that the starting 
address is saved as S. Meanwhile A is used as a working address. It changes to tell 
the computer which address to POKE successive data into. 


Example: 


STARTING ADDRESS FOR M/L=?768 ~— S=768 from your input 
HOW MANY BYTES?6 + В=6 from your input 
PRESS RETURN TO ENTER PROGRAMm 


-— ——— A-7168 after RETURN is 
Second 2 


pressed 

We will next have the Operating System print each address in turn and 
wait for you to enter a two-digit hexadecimal code for either an instruction code 
from your machine language reference or a byte of hexadecimal data. Remem- 
ber, the Operating System will take care of converting the hexadecimal values to 
decimal values. It does this in a subroutine located at line 1000. After the con- 
version takes place, the decimal result is POKEd into the specified address. The 
address is then increased by one at line 290, and the next entry is requested. 
This continues until you have entered the entire program. 


Address + 1 = Next Address 


SECTION 2 


200 REM * ENTER PROGRAM IN HEX — CONVERT TO DECIMAL * 

210 FORE=1TOB 

220 PRINT A; SPC(2); + Address is printed 

230 GET H$: PRINT H$; , ~— Hex data follows 

240 GET U$: PRINT U$ | 

250 IF ASC(H$)<48 OR ASC(H$)>70 OR (ASC(H$)>57 AND 
ASC(H$)«65) THEN PRINT “1ST DIGIT NOT HEX — TRY 
AGAIN": GOTO 220 

260 IF ASC(U$)<48 OR ASC(U$)>70 OR (ASC(U$)>57 AND 
ASC(U$)<65) THEN PRINT “2ND DIGIT NOT HEX — TRY 
AGAIN": GOTO 220 

270 GOSUB 1000 | -«——————— Convert to decimal 


280 POKE A,D -——— ———— Put data in memory 
290 А=А+1 —— — — Next address 
300 NEXT E 
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Lines 250 and 260 ensure that your data entries are in valid hexadecimal 
format. They do not ensure that a valid machine language instruction has been 
used. This is up to you, the programmer. 


Example: 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 
PRESS RETURN TO ENTER PROGRAM 


768 в С 


Computer waits for the data entry 


After all except the last instruction has been entered. 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 
PRESS RETURN TO ENTER PROGRAM 


768 A9 
769 13 
770 8D -———— Hexadecimal equivalents to the values shown 
771 25 in the POKE and PEEK DEMONSTRATION 
772 03 program. 
773 9 = 
N This entry will be 60. Then the program will 
A increases for proceed to the next section. 
each entry (768, | 
769, etc.) 


Third B 


We should now print the program so that you can check it for errors. A 
subroutine will be written at line 2000 to do this. We'll assume that it has been 
done for now but come back to it later. We also want to allow provision for 
making changes in the program in case an error is discovered. Our demonstration 
program is very short and can be shown in its entirety on the screen by the 
Section 2 routine. Therefore, this section may seem unnecessary to you. How- 
ever, your programs will be longer in the future, and some will probably not 
fit on the screen. The printing subroutine will display your programs 20 lines 
at a time so that you may see 20-line blocks of your program. 

When using this section, look through the entire program and note any 
changes that you want to make. Changes are made after the complete pro- 
gram has been displayed by the subroutine and a RETU RN is made to line 420. 
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SECTION 3 


400 REM *PRINT M/L PROGRAM AND CHECK FOR CHANGES * 

410 GOSUB 2000 -— Print the program 

420 PRINT “IF ANY CHANGES-TYPE ADDRESS" 

430 PRINT “IF NOT — TYPE 99" 

440 INPUT AD 

450 IF AD=99 GOTO 700 -«— Execute the program 

460 PRINT AD; 

470 PRINT "DATA-2?' -«— Get the change 

480 GET H$: PRINT H$; 

490 GET U$: PRINT U$ 

500 IF ASC (H$)<48 OR ASC(H$)>70 OR (ASC(H$)>57 AND 
ASC(H$)<65) THEN PRINT “1ST DIGIT NOT HEX — TRY 
AGAIN”: GOTO 460 

510 IF ASC (U$)<48 OR ASC(U$)>70 OR (ASC(U$)>57 AND 
ASC(U$)<65) THEN PRINT “2ND DIGIT NOT HEX — TRY 
AGAIN”: GOTO 460 

520 GOSUB 1000 

530 POKE AD,D -—— Change it 


If there are some changes, you should type in the address where the 


change is to be made (line 440). That address is then printed followed by the 
question DATA-?. You then enter the correct data in hexadecimal format. It 
is converted to decimal form by the subroutine at line 1000 and entered into 


memory by line 530. 


Example: 
No changes to be made after the program is printed. 


HERE IS YOUR PROGRAM 


768 A9 

769 13 

770 8D 

771 25 

772 03 

773 60 

PRESS ANY KEY TO CONTINUE ~— We pressed a key here 
IF ANY CHANGES-TYPE ADDRESS 

IF NOT — TYPE 99 


program would then be executed. 


If a change is to be made after the program is printed 
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?99 -— — — — We typed 99 here — no changes. The 


768 
769 
770 
771 
172 
713 


?768 


HERE IS YOUR PROGRAM 


АО 
13 
8D 
25 
03 
60 


-—————————— Error seen here Oh, Oh! 


PRESS ANY KEY TO CONTINUE  -— We pressed a key here after 
IF ANY CHANGES-TYPE ADDRESS spotting the error. 

IF NOT — TYPE 99 

-«—— We typed the address 

768 ОАТА=?А9 -4——————— Then the correct data 


We must wait for the next section to see what happens now. (ror) 


Fourth Al, 


More than one change may be necessary. So we follow Section 3 with an 
opportunity for you to make more changes. This section is only executed fol- 
lowing a correction to the program. 


SECTION 4 


600 REM * CHECK FOR MORE CHANGES * 
610 INPUT “ANY OTHER CHANGES (YES OR NO)?”; C$ 
620 IF LEFT$(C$,1) = "Y" THEN GOTO 420~— If yes, make changes 


630 GOSUB 2000 


-— ——— Then print the program again 


640 INPUT “ANY OTHER CHANGES (YES OR NO)?"; C$ 
650 IF LEFT$(C$,1) = "Y" THEN СОТО 420 


Line 610 asks if there are any more changes. If the response is NO, the 
program is printed again to let you examine it one more time. It then returns to 
give you one last chance for another change at line 640. If your answer is NO 
again, the program moves on to the execution section. 

If your response is YES (or at least begins with Y because of the LEFT$ 
statement in line 620 and 650), the computer goes back to line 420 for another 
change. You will stay in this loop until the program has finally changed to your 


satisfaction. 


Let's suppose that you have made two errors in the original entry of your 


program. 
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Example: 


768 
769 
770 
771 
772 
773 


B9 
13 
8C 
25 
03 
60 


HERE IS YOUR PROGRAM 


Olde Myth 


To err is human 


Do you see the errors? 
New Myth 


Computers never err 


PRESS ANY KEY TO CONTINUE® 


You spot the errors and want to make changes. Press any key. 


first change — 


second change — 


768 
769 
770 
771 
772 
713 


HERE IS YOUR PROGRAM 


B9 
13 
8С 
25 
03 
60 


PRESS ANY KEY TO CONTINUE -« You pressed а key 
IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?768 


——— — — You typed the address 


768 DATA=?A9 -«——————— Then the data 

ANY OTHER CHANGES (YES OR NO)? YES «You an- 

IF ANY CHANGES—TYPE ADDRESS swered YES 
IF NOT — TYPE 99 


?770 


4 —————— You typed the address 


770 DATA2?8D -—— — —- Then the data 
ANY OTHER CHANGES (YES OR NO)?NO < You typed 


NO 


The screen then goes blank, and the corrected program is shown. 
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HERE IS YOUR PROGRAM 


768 A9 

769 13 

770 8D 

771 25 -«— |t looks ok, so you press a key. 

| 772 03 

773 60 

PRESS ANY KEY TO CONTINUE To this last chance, 
ANY OTHER CHANGES (YES OR МО)?МО“ you type NO 


The program then goes on to execute the program in the next section. 


Fifth 5 


This section executes the machine language program. It stops at line 710 
to allow you to gather your courage once more. Will it run correctly or not? You 
press a key and presto! It’s finished, quick as a wink. Boy, that was fast. 


SECTION 5 


700 REM * EXECUTE THE MACHINE LANGUAGE PROGRAM * 
710 PRINT “PRESS ANY KEY TO RUN”: GET A$ 


-————— Plenty of space left here to add any custom 
: inputs to the program 
800 CALL S -—————S is the variable for the starting address. 


-«— —— —More space for statements to get results of 
: machine language program 
900 END 


The machine language program is called at line 800. Notice the space left 
between line 710 and 800. You can enter additional BASIC statements here to 
provide special inputs to your machine language programs if you desire, i.e., 
POKE address, DATA. The space between lines 800 and 900 allows BASIC 
statements to read results from your machine language programs, i.e., PEEK 
(address). 

For example, our demonstration program supposedly loaded the hexa- 
decimal value of 13 and put it into memory location 0325 (also a hexadecimal 
value). If the program worked correctly, the decimal value 19 (HEX 13) should 
have been placed into the memory location whose address is 0325 (lines 771 
and 772 of the machine language program). This value in decimal form would be 
805 (3 X 162 + 2 X 16 + 5). We can find out if it really did this by typing: 


PRINT PEEK(805) 


after the machine language program has been executed. 
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Example: 


HERE IS YOUR PROGRAM 


768 A9 
769 13 
770 8D 
771 25 
772 03 
773 60 
PRESS ANY KEY TO CONTINUE ~—— You pressed a key ' 
ANY OTHER CHANGES (YES OR NO)?NOW ? 
PRESS ANY KEY TO RUN Sic. ТОП typed NO 
You pressed a key ? ? 


J PRINT PEEK (805) 
19 


„ ык value PEEKed at is 19. This is the decimal equivalent 
of the hexadecimal value 13 that was entered, and it has 
been moved to the correct memory location. 


Sixth 


Last of all come the subroutines of the Operating System. The first one 
converts the hexadecimal data to decimal values for the BASIC interpreter. 


SECTION 6A 


1000 REM * CONVERT HEX TO DECIMAL * 
1010 M-ASC(H$): N=ASC(U$) aay b T" 
1020 IF M>57 THEN M=M-55: GOTO 1040 

_ OUT 
1030 M=M-48 
1040 IF N>57 THEN N-N-55: GOTO 1060 / \ 
1060 D=16*M+N | 
1070 RETURN 


Line 1020 checks the ASCII code for the first hexadecimal digit. It will be 
one of the values shown in the following table under the heading ASCII. Lines 
1020 and 1030 convert the HEX value to its equivalent decimal value. 
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Examples: 


1. A hexadecimal value of 8 has an ASCII code of 56. Therefore, M is not 
>57, so line 1030 is executed. The new M = 56 - 48 = 8 (the decimal 
equivalent of 8). 


2. A hex value of B has an ASCII code of 66. Therefore, M57 in line 
1020. The New M = 66 - 55 = 11 (the decimal equivalent of B). 


The same procedure is followed for the second digit at lines 1040 and 1050. 
Here is a table of conversions between hexadecimal, ASCII, and decimal values. 


CONVERSION TABLE 


Hexadecimal Converted 
digit decimal value 


Won ANN Боо кюю — 0 


0 
1 

2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 


A two-digit hexadecimal number has the following place values: 


first digt— М N second digit 
tells how tells how 
many 16's many 1's 


In hexadecimal form, M and N may be any HEX digit O through F. Lines 1020 
through 1050 convert these hexadecimal digits (0 through F) to their decimal 
equivalents (0 through 15). 


M is now the decimal number of 16's (0 through 15) 
N is now the decimal number of 1's (0 through 15) 


The decimal equivalents are then combined into a decimal number by multiply- 
ing 16 times the decimal equivalent of M and adding the decimal equivalent of 
N. Line 1060 performs this final operation. 
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Example: 


ASCII 67 
Original hexadecimal number = C7 
| NL —ASCII 55 
from line 1020 New M = 67-55 = 12 
from line 1050 New N = 55-48 = 7 
from line 1060 D = 16x12 + 7 = 199 (the decimal equivalent of C7 
hexadecimal) 


The print subroutine displays up to 20 lines of your machine langauge pro- 
gram at one time. The computer waits for you to examine these lines and press a 
key before displaying the next 20 lines of the program. This subroutine may be 
entered from the third or fourth section of the program depending on whether 
changes have been made. It returns to the same section from which the entry 
was made. 

Line 2030 initializes counters J to 0 and | to 19 so that 20 addresses and 
data values will be displayed on the screen by the FOR-NEXT loop at lines 2200 
through 2220. 


SECTION 6B 


2000 REM * SUBROUTINE TO DISPLAY PROGRAM * 
2010 HOME: PRINT “HERE IS YOUR PROGRAM” 

2020 PRINT 

2030 J=0: 1=19 

2040 ON INT((B-1)/20)+1 GOTO 2090, 2080, 2070, 2060, 2050 
2050 GOSUB 2200 

2060 GOSUB 2200 

2070 GOSUB 2200 

2080 GOSUB 2200 

2090 I-B-1:GOSUB 2200 

2100 RETURN 


2200 HOME 

2210 FORE=JTO! 

2220 PRINT 5+Е; SPC(2);: GOSUB 3000 

2230 NEXT E 

2240 PRINT “PRESS ANY KEY TO CONTINUE”: GET A$ 
2250 )=1+1: 121420 

2260 RETURN 


Line 2040 uses the number of program bytes to calculate how many blocks of 
20 lines must be displayed. It uses the ON-GOTO statement to select the number 
of times the block print subroutine will be used (at line 2200). Line 2090 dis- 
plays the last block of program lines. This block may not be 20 lines long. There- 
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fore, the upper limit of the FOR-NEXT loop is changed to reflect the number of 
program liries left to be displayed. The screen is cleared at line 2200 each time 
a new block of lines is to be printed. The program halts at line 2240 so that you 
can closely examine the lines for errors. When you press any key, the next block 
of lines is displayed. 

Last is the subroutine that converts the data from the decimal values 
selected by the PEEK (at line 3010) to the hexadecimal values used for data. 


SECTION 6C 


3000 REM * CHANGE TO ASCII AND DISPLAY * 
3010 Y = PEEK(S+E) 

3020 H = INT(Y/16) 

3030 U = Y-16*H 

3040 IF H<10 THEN PRINT H;: GOTO 3060 
3050 PRINT CHR$(H+55); 

3060 IF U<10 THEN PRINT U: GOTO 3080 

3070 PRINT CHR$(U+55) 

3080 RETURN 


Line 3010 PEEKs at the content of the address being displayed. Lines 
3020 and 3030 separate the decimal value into the number of 16’s (H) and the 
number of 1’s (U). Lines 3040 through 3070 convert H and U to their ASCII 
equivalents for display. 

Since we will be using this Operating System quite often in future chap- 
ters, it would be to your advantage to enter it in the computer and then save it 
on cassette or diskette. Then it can be loaded quickly when needed. 


Basically the Operating System allows you to: 
1. Enter a machine language program 


2. Alter any of your entries 


3. Run the machine language program 


Instruction in the use of the Operating System will be given as needed in the fol- 
lowing chapters. 


THE COMPLETED BASIC OPERATING SYSTEM 


Here is the completed BASIC Operating System. You should enter it into 
your Apple. When you have tried it out to make sure it works correctly, save it 
on cassette tape or disk. It will be too tedious to type it in every time you want 
to use it. 
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BASIC OPERATING SYSTEM 


100 REM * GET MACHINE LANGUAGE INFORMATION * 
110 HOME 

120 INPUT "STARTING ADDRESS FOR M/L=?”;S 

130 INPUT "HOW MANY BYTES?"; В 

140 INPUT "PRESS RETURN TO ENTER PROGRAM"; A$ 
150А = 5 


200 REM * ENTER PROGRAM IN НЕХ — CONVERT TO DECIMAL * 

210 РОВ Е = 1 TOB 

220 PRINT A; SPC(2); 

230 GET H$: PRINT H$; 

240 GET U$: PRINT U$ 

250 IF ASC(H$)«48 OR ASC(H$)>70 OR (ASC(H$)>57 AND 
ASC(H$)<65) THEN PRINT “1ST DIGIT NOT HEX — TRY 
AGAIN”: GOTO 220 

260 IF ASC(U$)<48 OR ASC(U$)>70 OR (ASC(U$)>57 AND 
ASC(U$)<65) THEN PRINT “2ND DIGIT NOT HEX — TRY 
AGAIN”: GOTO 220 

270 GOSUB 1000 

280 POKE A,D 

290 A= A*1 

300 NEXT E 


400 REM * PRINT M/L PROGRAM AND CHECK FOR CHANGES * 

410 GOSUB 2000 

420 PRINT “IF ANY CHANGES—TYPE ADDRESS" 

430 PRINT “IF NOT — TYPE 99" 

440 INPUT AD 

450 IF AD-99 GOTO 700 

460 PRINT AD; 

470 PRINT "DATA-?"; 

480 GET H$: PRINT H$; 

490 GET U$: PRINT U$ 

500 IF ASC(H$)<48 OR ASC(H$)>70 OR (ASC(H$)>57 AND 
ASC(H$)<65) THEN PRINT “1ST DIGIT NOT HEX — TRY 
AGAIN”: GOTO 460 

510 IF ASC(U$)<48 OR ASC(U$)>70 OR (ASC(U$)>57 AND 
ASC(U$)<65) THEN PRINT 2ND DIGIT NOT HEX — TRY 
AGAIN”: GOTO 460 

520 GOSUB 1000 

530 POKE AD,D 
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600 REM * CHECK FOR MORE CHANGES * 

610 INPUT “ANY OTHER CHANGES (YES OR NO)?"; C$ 
620 IF LEFT$(C$,1) = “Y” THEN GOTO 420 

630 GOSUB 2000 

640 INPUT “ANY OTHER CHANGES (YES OR NO)?”; C$ 
650 IF LEFT$(C$,1) = “Y” THEN GOTO 420 


700 REM * EXECUTE THE MACHINE LANGUAGE PROGRAM * 
710 PRINT "PRESS ANY KEY TO RUN”: GET A$ 


800 CALLS . 


900 END 


1000 REM *CONVERT HEX TO DECIMAL * 
1010 M=ASC(H$): N=ASC(U$) 

1020 IF M>57 THEN M=M-55: GOTO 1040 
1030 M-M-48 

1040 IF N>57 THEN N=N-55: GOTO 1060 
1050 N=N-48 

1060 D=16*M+N 

1070 RETURN 


2000 REM * SUBROUTINE TO DISPLAY PROGRAM * 
2010 HOME: PRINT “HERE IS YOUR PROGRAM” 
2020 PRINT 

2030 J=0: 1=19 

2040 ON INT((B-1)/20)+1 GOTO 2090,2080,2070,2060,2050 
2050 GOSUB 2210 

2060 GOSUB 2210 

2070 GOSUB 2210 

2080 GOSUB 2210 

2090 I-B-1: GOSUB 2210 

2100 RETURN 


2200 HOME 

2210 FORE=J TOI 

2220 PRINT S+E; SPC(2);: GOSUB 3000 

2230 NEXT E 

2240 PRINT “PRESS ANY KEY TO CONTINUE”: GET A$ 
2250 )=1+1: 1=1+20 

2260 RETURN 
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3000 REM * CHANGE TO ASCII AND DISPLAY * 
3010 Y = PEEK(S+E) 

3020 H = INT(Y/16) 

3030 U = Y-16*H 

3040 IF H«10 THEN PRINT H;: GOTO 3060 
3050 PRINT CHR$(H+55); 

3060 IF U<10 THEN PRINT U: GOTO 3080 

3070 PRINT CHR$(U+55) 

3080 RETURN 


EXERCISES 


. The BASIC language uses 1 питбегѕ. 
(HEX, binary, decimal) 
. When you use the statement: 
POKE address, data 
both address and data must Бе . .— numbers. 
(HEX, binary, decimal) 

. If you executed the following four statements in the Immediate Mode, fill in 
what would be printed on the line following the PRINT PEEK statement. 

POKE 768,169 

POKE 769,19 

POKE 770,141 

PRINT PEEK(769) 


. Explain the function of the CALL statement. 


. When using the BASIC Operating System, the addresses for the machine 
language program being entered will be printed on the screen using 
numbers. 
(decimal, HEX, binary) 
. The data and instructions which you enter (by the BASIC Operating Sys- 
tem) for the machine language program must be entered using 


numbers. 
(decimal, HEX, binary) 
ANSWERS TO EXERCISES 
. Decimal 
2. Decimal 
. 19 
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4. The CALL statement causes a machine language subroutine to be executed. 
The beginning address of the subroutine must be given. (Example: CALL 


768 would call a machine language subroutine beginning at the memory 
location whose address is 768.) 


5. Decimal 
6. HEX 
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Chapter 3 


Instruction Code Format 


BOS 


The Central Processing Unit (CPU) of the Apple computer was originally 
manufactured by MOS Technology, Inc. At the present time, two other com- 
panies (Synertek and Rockwell) also manufacture the CPU. This unit is named 
the 6502 microprocessor. It is called a central processing unit because all in- 
structions and numerical values are routed there for processing. 

The 6502 microprocessor (and hence, the Apple computer), like many 
other microprocessors, understands only instructions that are coded in blocks 
of eight binary digits, called bytes. Therefore, the biggest hurdle to machine 
language programming is to learn to work with information in binary form. 


0.1 1 1 11 0 1| Block of 8 “bits” 
or 1 "byte" 


[1]-—0ne bit 
[10]-—Two bits (not worth much these days) 
1101 |-*—Four bits (sometimes referred to as a nybble) 
01111101 [-*—Eight bits (commonly called a byte) 
The Apple uses words that are eight bits in length; that is, it can digest 
words whose size is one byte. All instructions and numerical values must be 
sent to its central processing unit in this byte size. A typical instruction, shown 


below, loads the computer's accumulator with the one byte of data following 
the instruction in a machine language program. 
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LOAD ACCUMULATOR IMMEDIATE 
MNEMONIC CODE BINARY CODE 
(abbreviation) 


Don't let the computer terminology throw you. The accumulator is similar 
to a memory location that is used in special ways we will discuss later on. We are 
just introducing it here to show the format of an instruction. 

The computer is composed of many functional parts that we will intro- 
duce as needed to explain the operations taking place. The central processing 
unit of the Apple is a 6502 microprocessor. The following block diagram shows 
the "parts" we are presently concerned with. 


MEMORY 


6502 MICROPROCESSOR 


Accumulator 


Other controls and 
registers 


The instruction decoder of the 6502 “reads” the instruction and decodes 
it. Most instructions involve the accumulator (discussed later in this chapter) as a 
center for moving and manipulating data. Memory is separate from the 6502 
microprocessor. 


NUMBER SYSTEMS 


Y ou can see that entering many binary-coded instructions would be tedi- 
ous. Since there are only two symbols (0 and 1), the binary representation of 
numbers is quite long. Most computers, including the Apple, have the ability to 
accept a shorthand representation of binary. This shorthand is the hexadecimal 
number system (which we will often refer to as HEX). Four binary digits may be 
represented by one HEX digit. Thus, our 8-bit instruction may be represented by 
a 2-digit HEX number by breaking the byte (8 bits) into two parts (nybbles). 
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Binary Number Call me a byte 
01111101 v 
f 


DMY O 


AA 
ne Ly » 
ys yoo" Ws 6, x 


0111=7HEX 1101=DHEX 


Binary Two Nybbles HEX 
Therefore: 01111101 =0111 1101 = 7D 


mw 


The hexadecimal number system has 16 symbols (0,1,2,3,4,5,6,7,8,9,A,B, 
C,D,E,F). The relationship of decimal, binary, and HEX values is shown in the 
following table. 


о 00-10 ол Б 00 м — © 


0 
1 

2 
3 
4 
5 
6 
7 
8 

9 
А 
В 
С 
D 
E 
F 
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О 


O O 
ooo «САШ me 15, CALL me 1111, or CALL me F — they all 
ОООО represent the same thing. 
OOOOO 


To give the table meaning, let's take a look at the binary system. Each place 
value in the binary system is a power of two, just as each place value in the 
decimal system is a power of ten. Two is called the base of the binary system, 
and ten is called the base of the decimal system. If we look at the place values 
of the binary numbers 0000 through 1111, we can attach more meaning to 
them. 


[ ge |] Places 
Decimal 
Equivalent 


0+0+0+1 = 1 
0+0+2+0 = 2 
0+4+0+0 = 4 
8+0+0+0 = 8 


Using combinations of these place values, we may obtain any decimal value from 
О through 15 or any HEX value from О through F. 


Examples: 


0101 = 22 + 2= 4 + 1 = 5 decimal and also 5 HEX 

1010 = 23 + 2! = 8 + 2 = 10 decimal which is А HEX 

1100 = 2? + 22 = 8 + 4 = 12 decimal which is C HEX 

1101 = 23 + 22 + 20 = 8 +4 + 1 = 13 decimal which is D НЕХ 


Let's now take a closer look at how we may express any 8-bit binary num- 
ber by two HEX digits. We saw earlier that the highest HEX digit (F) corres- 
ponds to the four-bit binary value 1111. The next higher binary value is 10000. 
The one is in the 2* place, which equals 16. Therefore, we have one 16 and 
nothing else. This can be expressed by the HEX value 10, which means one 16 
and no 1’s. There is a direct relationship between the upper 4 bits of an eight- 
bit binary number and the sixteen's place digit of a HEX number. 


Binary Places 


HEX value 
16! 


2% = 16 

25 = 2*16 = 32 
26 = 4*16 = 64 
27 = 8*16 = 128 
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Next look at the binary place values of the complete 8-bit number. 


Binary Places 
Decimal 


25:329: 27 2E Эз оюк. De 20 Equivalent 


0+0+0+0+0+0+0+1 = 1 
0+0+0+0+0+0+2+0 = 2 
0+0+0+0+0+4+0+0 = 4 
0+0+0+0+8+0+0+0 = 8 
0+0+0+16+0+0+0+0 = 16 
0+0+32+0+0+0+0+0 = 32 
0+64+0+0+0+0+0+0 = 64 
128+0+0+0+0+0+0+0 = 128 


0 
0 
0 
0 
0 
0 
0 
] 


om соо ооо 
oo- о осо ооо 
о сос со е осо со оо 
oo осо осо "00 о 
ooooo- O © 
оо ооо оно 
оо ooooo = 


Using combinations of all eight bits, you may obtain any decimal value 
from O through 255, or any HEX value from О through FF. If we break an 8-bit 
binary number into two 4-bit parts, each part may be represented by one HEX 
digit. 


Examples: 


BINARY 01111101 64+32+16+8+4+1 = 125 in decimal 
s SPLIT-BINARY 0111 1101 


Broken (split) HEX 7D X 7*16+13 = 125 in decimal 
into 
Du BINARY 11000011 1284644241 = 195 in decimal 


SPLIT-BINARY 11000011 © 
HEX C3 12*16+3 = 195 in decimal 


BINARY 10101010 128+32+8+2 = 170 in decimal 
SPLIT-BINARY 10101010 
HEX AA 10*16+10 = 170 in decimal 


Instruction manuals for machine language quite often list the instruc- 
tion codes in both binary and HEX forms. Our BASIC (to machine language) 
Operating System will use HEX format for entering the instructions of ma- 
chine language programs. Since BASIC doesn’t understand HEX numbers, the 
operating system will convert them to decimal numbers for BASIC and to 
binary numbers for the computer. Even though the BASIC Operating System 
was discussed in Chap. 2, we believe the data-entry section should be repeated 
here. 

Instructions are input in lines 200-300 of the BASIC (to machine lan- 
guage) Operating System as hexadecimal numbers. 
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SECTION 2 


200 REM * ENTER PROGRAM IN HEX — CONVERT TO DECIMAL * 

210 FORE=1TOB 

220 PRINT A; SPC(2); -————Address is printed 

230 GET H$: PRINT H$; рее data follows 

240 GET U$: PRINT U$ 

250 IF ASC(H$)<48 OR ASC(H$)>70 OR (ASC(H$)>57 AND 
ASC(H$)<65) THEN PRINT “1ST DIGIT NOT HEX — TRY 
AGAIN": GOTO 220 

260 IF ASC(U$)<48 OR ASC(U$)>70 OR (ASC(U$)>57 AND 
ASC(U$)«65) THEN PRINT “2ND DIGIT NOT HEX — TRY 
AGAIN": GOTO 220 

270 GOSUB 1000 -4— ————- Convert to decimal 


280 POKE A,D ~—— Put data in memory 
290 А=А+1 -— — ——— Next address 
300 NEXT E 


The HEX-to-decimal conversion takes place in the subroutine at lines 
1000-1070 of the operating system program. The BASIC interpreter then 
changes the decimal numbers to binary equivalents for the computer. 


1000 REM *CONVERT HEX TO DECIMAL* 
ASCII codes—- 1010 M-ASC(H$): N=ASC(U$) 


in decimal 1020 IF M>57 THEN M=M-55: GOTO 1040 

(M,N) 1030 M2M-48 

Conversion—> 4 1040 IF N>57 THEN N=N-55: СОТО 1060 
1050 N=N-48 


1060 D=16*M+N 
1070 RETURN 


Й A 


DECIMAL 


BLOCK DIAGRAM OF INPUTS 


HEX HEX TO DECIMAL TO USES THE 

>| DECIMAL [| BINARY "| BINARY 
Keyboard Operating BASIC Computer 
Input System Interpreter 


Ours is on pages 40 and 41 
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The computer handles data in 8-bit blocks called bytes. Therefore, one 
byte of data is limited to the binary value 11111111 (FF hex or 255 decimal). 
However, by combining two bytes of data, much larger values may be handled. 
The computer uses this method to access locations in its memory. 

When a two-byte number is used, one byte is referred to as the Least 
Significant Byte (LSB). The other is referred to as the Most Significant Byte 
(MSB). 


Example: : 
MSB (Most Significant Byte) LSB (Least Significant Byte) 


21:190. 95.99 2% 124» 901289 Di 299: 99. De 0%: 02 91 


Don't confuse the Most and Least Significant Bytes with the most and least sig- 
nificant bits. Each byte has an msb (most significant bit) and an Isb (least signifi- 
cant bit). 


MOST SIGNIFICANT BYTE LEAST SIGNIFICANT BYTE 


27 26 25 2% 23 22 2! 29 27 26 25 24 23 22 21 20 


Z РА Ls "a 
significant significant significant significant 
bit bit bit bit 


To use a two-byte number, you consider the Most Significant Byte as an exten- 
sion of the Least Significant Byte. The place values of the Least Significant Byte 
were assigned powers of two from O through 7. 


LSB 
27 960 99. 99 29 292: 9! 9° 
0 1 0 0 O 1 1 1 


The place values of the Most Significant Byte are assigned the next higher 
powers of two (8 through 15). 


=64+4+2+1=71 (decimal) 
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MSB 


215 214 213 212 211 210 29 28 


= 32768 + 2048 + 256 = 35072 
(decimal) 


The decimal value resulting from the combined bytes (considered as one num- 
ber) is: 


215 214 213 212 211 210 29 28 27 26 25 24 23 22 21 20 


In decimal: 32768 + 2048 + 256 + 64 + 4 + 2 + 1 = 35143 


Split into 4-bit parts: 
1000 1001 0100 0110 ~—— This binary value 
И cM 5 is equivalent to 


HEX digits 8 9 4 6 -«— this HEX value 
HEX 
+ 9*256 = 2304 
+4*16 = 64 
+ 7*1 = 7 
35143 
(decimal) 
ACCUMULATOR 


The accumulator is a register (a storage place similar to a memory loca- 
tion) in which data is placed. It is used as a temporary storage area when mov- 
ing data from one memory location to another. Arithmetic and logical opera- 
tions on data also take place in the accumulator. Thus it is frequently used, and 
many of the 6502 instructions involve it. Remember, the Apple computer uses 
the 6502 central processing unit. The instructions are fixed in the 6502; that is, 
each instruction has a unique, unchanging machine language code. 

The accumulator also holds one byte of data. 
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The necessity for two-byte values becomes apparent when an instruction 
is used to acquire data from a memory location. If you want to load data into 
the accumulator from memory, the following instruction could be used. 

One instruction for putting a number into the accumulator was shown 
previously. It loads the accumulator with. a number which immediately follows 
the instruction. 


Example: 

Binary HEX ~—This is the value typed in 
Value Value 

10101001 A9 -—— —Load the accumulator 
00001101 13 -«———with HEX value 13 


The two bytes (each occupying a separate memory location) provide: 


First: the instruction, Load the accumulator (A9) 
Second: with the HEX value 13 


The next instruction introduced shows a second way to put a number into 
the accumulator. It obtains the number to be loaded from a specified memory 
location. Even though the mnemonic code for this instruction is LDA (the same 
as the one referred to at the beginning of the chapter), the HEX value represent- 
ing this instruction is different. 

When you are loading the accumulator from a specified memory location, 
the LDA instruction has a HEX code of AD. Even though this means nothing to 
you, it is a specific instruction to your Apple. The memory location is specified 
following the instruction. Notice that the two bytes necessary for specifying 
the address of the memory are given in reverse order. This may seem ridiculous 
to you. But to the computer, it is entirely logical. The Least Significant Byte 
is stored in the lower address of memory, and the Most Significant Byte is stored 
in the higher memory address. 


HEX | Mnemonic 
Value Code Operand Remarks 


AD 0325 Load the accumulator from 
25 memory location 0325 


03 | Ше (НЕХ) 


Instruction Reversed order for address 
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This is an example of a three-byte instruction. 
1. The instruction is given in the first byte. 
2. The LSB of the memory appears as the next byte. 
3. The MSB of the memory appears as the last byte. 


When the computer executes this instruction, the data in memory location 
0325 is copied into the accumulator. This one change occurs: 


p pets 0325 


BEFORE: E mmm 


AFTER: 101100 | PTUS 


The value in the memory location remains unchanged and is copied into 
the accumulator. Operations can be performed on the value in the accumulator. 
The results can then be transferred to another location if desired. The important 
thing to remember is that most of the computer's action takes place in the 
accumulator. Therefore, many of the 6502 instructions involve this useful 
register. 

Data from the accumulator can be copied into some memory location 
with a store instruction such as: 


HEX | Mnemonic 
Value Code Operand REMAR 


Store the value contained 
in the accumulator into 
memory location 0326 
HEX 


Instruction —- 
Memory 
Location 


This is another three-byte instruction. In general, most instructions that 
refer to a memory location require three bytes. Exceptions will be noted later. 

When the computer executes this instruction, the data in the accumulator 
is copied into the specified memory location. This change occurs: 


| perm | 0326 


BEFORE: | 10011001 | Lan | 


AFTER: mm ma 


The value in the accumulator stays the same, but that value is copied (or writ- 
ten) into memory location 0326 as well. You can see that with instructions like 
LDA and STA, the accumulator is going to be a busy place. 
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It will also be important for you to keep track of what memory locations 
are being used for different operations. Remember, we are using memory loca- 
tions 0300 HEX upward (see memory map in Chap. 2). Whenever data is stored 
in a memory location, the data that was previously there is lost. 


Example: 
Suppose that the following values are in the memory locations shown. 


Memory (Hex) Content 


0325 19 
0326 24 
0327 00 


This machine language program is then executed. 


768 AD Load accumulator from 
769 25 memory location 0325 
770 03 


now in accumulator 


771 8D “Store accumulator in 
772 27 methnory location 0327 
773 03 


These machine lan- 
guage instructions 
work in a similar 
way to the two 
consecutive BASIC 
instructions: 


Memory locations now 
0325 19 
0326 24 
0327 -—— This has been changed 


774 AD Load accumulator from 
775 26 memory location 0326. 
03 | 


200 LET А=19 
210 LET A724 


now in accumulator 


8D Store accumulator in 
memory location 0327 


Memory locations now 
0325 19 


Program 
in these 


decimal ‹ : 0326 24 Л 
тетогу HISEFUCHOTS 0327 19 is now góne 


locations 
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INSTRUCTIONS IN MEMORY 


Programs must be put into memory before they can be run. Even your 
BASIC programs occupy memory space. Your BASIC interpreter takes care of 
BASIC program memory assignments for you, and you are unaware of the exact 
locations of BASIC instructions. However, you must assign memory locations to 
your machine language programs. Each instruction byte and each data byte must 
be assigned specific locations. Each byte occupies one memory location. 


Example: 


Memory Data or Instruction 
Location Byte Remarks 


Load accumulator 
from memory location 
0325 


Data to be loaded 


Some instructions have many forms. This load instruction differs from 
that used in "Memory Use" in Chap. 2 in that a value is loaded from a memory 
location rather than from the byte following the instruction. 

We will use memory locations 0300 through 03FF (HEX) for our machine 
language programs. This area of memory is not used by the Apple Operating 
System nor by the BASIC interpreter. Therefore, it is safe for our use. 

We'll use our BASIC Machine Language Operating System to POKE 
machine language instructions and data into this area of memory. 


USE OF THE BASIC-M/L OPERATING SYSTEM 


To demonstrate the use of the Operating System, we must first decide on 
the machine language program that we want to run. Your first effort will be a 
very short program that places some data into the accumulator and then moves 
it from there to a memory location. 

This program accomplishes the same thing as the BASIC instruction: 


ЕТА = 19 -— ————— This stores 19 in location named A 


*Notice again that the memory location 0325 is entered in the program LSB 
first, then MSB. This may seem backwards to you, but it is quite normal for the 
computer. The Most Significant Byte (MSB) is now stored in a higher memory 
location than the Least Significant Byte (LSB). 
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The LET statement merely stores the value 19 into a memory location assigned 
by the BASIC interpreter. 
The machine language equivalent takes two instructions: 


LDA (load accumulator with data) 
STA (store accumulator's contents in memory) 


1. We first /oad the accumulator with the data. 
The 6502 instruction for loading the accumulator with data that immediately 
follows is made up of two bytes. 


A9 ~<~——First byte 
XX ~—— Second byte 


A9 is the machine language code telling the computer to load the data 
which follows into the accumulator. 


XX is a two-digit HEX value that is to be loaded. 


The mnemonic code for the instruction and the Operand are usually added to 
give some meaning to the coded instruction. The actual instruction is called 
the Operation Code (Op Code for short). 


Example: 
Explains the codes 


Op Code ^M \ 


nemonic Code Operand | 
Two, Из, LDA | 13, the data 


bytes NY 


The mnemonic code is just the abbreviation for the instruction. The operand 
is the data or other item used. The operation code is the HEX code for the 
instruction to be performed or the data to be used. In this case it is the in- 
struction, Load Accumulator with immediate data. 

A list of machine language instructions used in this book is given in Appen- 
dix A-2. A complete list of 6502 instructions is given in Appendix D. 
The instruction actually consists of two bytes: 


This says LoaD Accumulator 
This tells what value to load 


A9 (the instruction) 
XX (the HEX data to be loaded) 


In our demonstration, we will load the value 19 (HEX=13). Therefore, the 
two-byte instruction will be: 


A9 
13 
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In the different number systems that we have discussed: 


Binary Split-binary HEX 
10101001 1010 1001 A9 
00010011 0001 0011 13 


These values are entered using 
the BASIC Operating System. 


2. We will then store the data in the memory location whose address is 0325 
(HEX). 
The 6502 instruction necessary to do this is: 


STORE ACCUMULATOR ABSOLUTE 


OPERATION CODE MNEMONIC OPERAND 
8D STA memory 
This instruction takes three bytes: 
8D (The instruction) 
25 (The least significant memory byte) 
03 (The most significant memory byte) 
| 8D The instruction 
| is placed in three 
successive memory locations 
3. We will then return from the machine language program to the operating 
system. 


The 6502 instruction used is: 
RETURN FROM SUBROUTINE 
OPERATION CODE MNEMONIC OPERAND 


' і f 


60 RTS none 
This is a one-byte instruction. 


60 (The instruction) 
It performs the same function as the BASIC instruction: 
RETURN | 
We noted on the Apple memory maps (Chap. 2) that memory locations 


768-1023 (decimal) would be used for machine language programs. That part of 
the map is shown here for reference. 
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Decimal HEX 
Address Equivalent 


Our first program. will begin at memory location 0300 HEX. We must tell 
our Operating System this location as a decimal value. The addresses are POKEd 
into the computer using decimal numbers that BASIC understands. But the in- 
structions and data must be POKEd in as HEX numbers, which the computer 
will use in their binary form. 


fo 1з о1о. 


This is the address where the first instruction of the program will be entered. We 
will also have to supply the Operating System with the operation codes for each 


address. 


LDA with 
data jure 
STA 
Memory (LSB) 
Memory (MSB) 
RTS 


-3X 16? = 3 X 256 = 768 decimal 


Notice: The program has 6 bytes (we will have to tell the 
Operating System this fact). 
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Here is a step-by-step description of how to use the Operating System 
to enter and run the above program. 


1. Enter the Operating System (see Chap. 2). This can be done from the 
keyboard, or from cassette or disk if you have previously saved the 


program. 


2. Type: RUN (and press RETURN) 


STARTING ADDRESS FOR M/L-?m 


3. Type: 768 (and press RETURN) 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?m 


4. Type: 6 (and press RETURN) 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 
PRESS RETURN TO ENTER PROGRAME 


5. Press the RETURN key 


STARTING ADDRESS FOR M/L=?768 
| HOW MANY BYTES?6 
PRESS RETURN TO ENTER PROGRAM 


768 m Computer supplies 

REL M d first address 
Now you type in the program. You do not have to press the RETURN key 
after each entry. The computer will automatically print the next address follow- 
ing your £wo-digit entry. If you make a mistake, go right on to the next entry. 
You will be able to correct any errors when the program has been entered 


completely. 
6. Type: A 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 | 
PRESS RETURN TO ENTER PROGRAM 


768 Am 1st digit of 
E d 1st address 
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7. Type: 9 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 

PRESS RETURN TO ENTER PROGRAM 
768 A9 -«——— — ———— Ist entry complete 


769 m Computer prints next 
Ne address 


Since you don’t have to press RETURN after each keystroke, we will include 
both keystrokes for each address in each step from now on. 


768 A9 


Computer You type this 
displays this buty 


The GET instruction does not require you to press RETURN. If you do 
press RETURN, the GET instruction interprets it as one of your characters, and 
the Operating System will display: 


768 
1ST DIGIT NOT HEX — TRY AGAIN 
768 m 


Getting back to the program, 


8. Type: 13 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 

PRESS RETURN TO ENTER PROGRAM 
768 A9 

769 13 

770 пт 
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9. Type: 8D 


STARTING ADDRESS FOR M/L-?768 
HOW MANY BYTES?6 

PRESS RETURN TO ENTER PROGRAM 
768 A9 

769 13 

770 8D 

771 a 


10. Type: 25 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 | 

PRESS RETURN TO ENTER PROGRAM 
768 A9 

769 13 

770 8D 

771 25 

772 т 


11. Туре: 03 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?6 

PRESS RETURN TO ENTER PROGRAM 
768 A9 


12. Type: 60 


768 A9 


769 13 

770 8D 

771 25 

772 03 

773 60 | 

IF ANY CHANGES-TYPE ADDRESS | 
IF NOT — TYPE 99 | 


?u 
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Before going on, let's compare this machine language program with its 
equivalent in BASIC. These six machine language instructions perform a func- 
tion very similar to two BASIC instructions: 


BASIC MACHINE LANGUAGE 
100 LET A = 19 768 A9 LDA13 
110 RETURN ND 769 13 
770 8D STA 0325 


771 25 
772 03 


773 60 RTS 


The machine language program loaded the accumulator with the HEX 
number 13 (19 decimal). It then stored it in a memory location. The BASIC 
statement LET A = 19 does the same thing. It stores the value named by the let- 
ter A into memory. The machine language instruction RTS (ReTurn from Sub- 
routine) performs the same function as the RETURN instruction in BASIC. 

Study the program to make sure all entries are correct. If you made an 
error in your entries, you would type in the address where the error was made. 
The computer would then display: | 


IF ANY CHANGES-TYPE ADDRESS 

IF NOT — TYPE 99 Suppose: 
2771 DATA=?8 — -—————— — Error seen at 
address 771 


You would then type in the correct data (two digits). 


IF ANY CHANGES-TYPE ADDRESS 

IF NOT — TYPE 99 

2771 DATA=?25 7*— Correct data entered 
ANY OTHER CHANGES (YES OR NO)? 


You would then type YES or NO. If you type YES, the computer would 
again ask for the address and data. The process is repeated until you give a nega- 
tive reply (NO more changes). The computer then prints the corrected program 
and asks if there are any more changes. On the last negative reply to changes, the 


computer displays: 
| PRESS ANY KEY TO RUN& 
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You press any key, and the machine language program is run. You will immedi- 
ately see the prompt and blinking cursor. My, that machine language is fast! 


PRESS ANY KEY TO RUN 
]= 


Did our machine language program really гип? How can we find out? 
BASIC has an instruction named PEEK ш! will let you see what is ina 
specified memory location. If you tell it: 


325 HEX (the location where the 


PRINT PEEK (805) program stored the value, 19 


it will print the value that is stored in memory location 805 (decimal). 

Since the M/L program was supposed to put the HEX number 13 (decimal 
19) into memory location 0325 HEX, we can PEEK at that location to see 
what's there. 


0325 HEX = (3 X 256)+(2 X 16)+(5 X 1) = 768 + 32 + 5 = 805 decimal 
Type: PRINT PEEK(805) and press RETURN 


Presto! There it is! 


] PRINT PEEK(805) 
19 -— И really worked! 


IL 


You can add a line to the Operating System between lines 800 and 900 to 
print the value in memory using the PEEK statement. 


~ 810 PRINT PEEK(805) 


This part of the operating system (lines 800-900) can be changed to custom fit 
each program you run. Add line 810 to the Operating System for your next 
program. 

The first program loads data into the accumulator and then stores it in 
memory. Practically all programs use this type of operation to move data from 
place to place within the computer. | 
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The accumulator is also used in performing operations on numbers. One 
such operation shifts each bit in the accumulator left one place. This operation is 
abbreviated ASL (Arithmetic Shift Left). Its OPeration CODE (OP CODE) is 
OA. 


Example: | | соч 
Accumulator's contents | aw | 
before the shift instruc- 16+2+1 = 19 (decimal) 
tion is executed 

This bit 

is lost 


Accumulator's contents | 
after the shift instruc- 00100110 32+4+2 = 38 (decimal) 
tion is executed 

б is automatically 


placed in the last bit 


You can see that an ASL instruction is one way to multiply a number by 
two, since the value of each bit is doubled. 

You can now load a number into the accumulator and shift each bit one 
place to the left (or multiply it by two). You can then store the result in a mem- 
ory location. The PEEK statement, which you have added at line 810 in the 
Operating System program, will then print the result stored in memory. 

Use the Operating System to load this program. After all 7 bytes have been 
entered, the display should show: 


HERE IS YOUR PROGRAM 


768 A9 -—— Load Accumulator with HEX value 13 
769 13 (19 decimal) 

770 OA -—- Shift bits left 1 place 

771 8D ~— Store results in memory (0325) 

772 25 

773 03 

774 60 -—- Return to Operating System 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


А 


When you type іп 99, the program will immediately show the value that 
has been stored in memory 0325 HEX (805 decimal). Remember that the value 
will be displayed as a decimal number. It should be 38. Here is the display when 
the program has been run: 
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HERE IS YOUR PROGRAM 


768 A9 

769 13 «—— (13 HEX = 19 decimal) 

770 OA 

771 8D 

772 25 

773 03 

774 60 

IF ANY CHANGES—TYPE ADDRESS 

IF NOT — TYPE 99 

299 

PRESS ANY KEY TO RUN 

38 4 —— ————— Answer comes back in decimal form from 
the BASIC instruction: PRINT PEEK(805) 

]s 


Since the value in the accumulator is doubled each time the ASL instruc- 
tion is executed, you can imagine what would happen if we executed ASL twice. 
The value would be doubled and then redoubled (or multiplied by four). Try it 
by adding a second ASL instruction to the program above. After you have en- 
tered the revised program and executed it, your display should look like this 
(remember, the program will now be 8 bytes long). 


HERE IS YOUR PROGRAM 


768 A9 

769 13 : 
770 OA | a— wo ASL instructions 
771 OA 

772 8D 

773 25 

714 03 

775 60 

IF ANY CHANGES- TYPE ADDRESS 
IF NOT — TYPE 99 

299 

PRESS ANY KEY TO RUN 


76 ———————— (19 times 4 = 76) 


]= 
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Here is what happened: 


00010011 -«— Original value in accumulator 
ASL executed: 
00100110 -—— Shifted left once 
ASL executed again: | 
01001100 -— Shifted left twice, which is 4 times 19 


Result: 64 + 8 + 4 = 76 


We will cover the arithmetic capabilities in more detail later in the book. 
Remember that the accumulator can hold only eight bits of data. Memory loca- 
tions also hold only eight bits. If we shift left too many times, the number will 
be shifted right out of the accumulator. We will have to find new techniques to 
take care of big numbers. | 

Arithmetic and logic functions are performed by the Arithmetic Logic 
Unit of the 6502 microprocessor. 


You have discovered that you can load numbers into the computer, change 
the values that you put in, move the values within the computer, and print out 
the results. In the next chapter, you'll discover something far more fascinating. 
You'll find out how to display graphics on the video display. 


SUMMARY 


You're off to a good start. In this chapter, you have learned: 
1. That the computer only understands binary instructions and data 


2. How to convert between decimal, binary, and HEX values 
3. That memory locations hold one byte or eight bits of data 


4. That the accumulator (a special register similar to a memory location) is used 
to conduct most computer operations 
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5. To use machine language instructions: 


a. LDA (LoaD Accumulator) used to load the accumulator with an immedi- 
ate value. Its OP CODE (A9) is followed by one byte of data which is 
loaded into the accumulator. 


Example: А9 —— OP CODE 
13 ~<«— data to be used 


b. STA (STore Accumulator) used to store the value in the accumulator in an 
absolute memory location. Its OP CODE (8D) is followed by the two-byte 
address. | 


Example: 8D -—— OP CODE 
25 ~<«— least significant byte of address 
03 ~<— most significant byte of address 


c. RTS (ReTurn from Subroutine) used to cause a return from a machine 
language program (or subroutine). 


Example: 60 | -«— OP CODE 


d. ASL (Arithmetic Shift Left) used to shift each bit in the accumulator one 
place to the left. It doubles the value in the accumulator. 


Example: OA —— ОР CODE 


6. To put all these instructions into a machine language program, entered and 
controlled by the BASIC Operating System 


Although you have only touched on a few machine language instructions, you 
were able to understand and use a machine language program. 

Most of the instructions that you will be using have several forms (or 
modes). They are shown in Appendix A. The ones that you will be using most 
are Immediate, Absolute, Implied, and Zero Page. 

You have used LDA in the Immediate Mode. In this mode, the data to be 
used immediately follows the OP CODE. You have also used the STA instruction 
in the Absolute Mode. In this mode, the complete (or absolute) address follows 
the OP CODE of the instruction. This address is given with the Least Significant 
Byte first, followed by the Most Significant Byte. The Implied Mode was used 
for the RTS instruction. Its function is implied by the instruction. Therefore, no 
address or data is needed. | 

These modes will become more familiar to you as they are used in future 
chapters. | 


69 


EXERCISES 


Fill in the blanks in the following exercises. 


1. 


BASIC uses numbers, but the computer only 
(decimal, binary) | 
understands . .  . . | . numbers. 
(decimal, binary) 


2. One HEX digit can be used to represent how many binary digits? 


3. Give the HEX and decimal equivalents of these binary numbers. 


Binary HEX Decimal 
1001 
1101 
01010111 
. Data is copied into the accumulator from memory with a 
instruction. (load, store) 
. Data is copied into memory from the accumulator with a 
instruction. (load, store) 
. Explain what the execution of the following instruction would do. 
Address Op Code Remarks 
771 8D STA 
712 40 memory 
713 03 


————————————————M——— M ——— MÀ € E 
U—————————————Ó—M———MM ———  É——— 


. The BASIC Operating System displays... . — 1 | ^ values for 


(decimal, HEX) 


program addresses and ________values for Op Codes and data. 
(decimal, HEX) 


. Fill in the results that would be placed in memory location 0333 by this 


program. 
768 A9 LDA 2C 
769 2C 
770 OA ASL 
771 8D STA 0333. 
772 33 
773 03 
774 60 RTS 


hex (in memory) —. ... ... decimal equivalent 


9. Tell what each of the following instructions кш when executed. 


a. A9 LDA 15 
15 


—————M———M ————  ——— M —— Pa 
————————M———— ———M Rl 
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.8D STA 0310 


ANSWERS TO EXERCISES 
1. Decimal; binary 
4 
. Binary HEX Decimal 
1001 9 9 | 
1101 D 13 
01010111 57 87 
. Load 
. Store 
. Store the value contained in the accumulator in memory location 0340. 
. Decimal; HEX —— 
. 58 HEX (in memory); 88 decimal equivalent | 


Con OY t A 


оо св 


(0010 1100 shifted left = 0101 1000 = 58 HEX 
58 HEX = 5 X 16 + 8 = 88 decimal) 


. LDA 15 loads the accumulator with the value 15 (HEX). 

. STA 0310 stores the accumulator's content into memory location 0310. 
. ASL shifts each bit in the accumulator one place to the left. 

. RTS causes a return from the subroutine where it is used. 


71 


Chapter 4 


Simple Graphics 


In Chap. 3, you found out how to load a number into the accumulator, 
perform an operation on it (shift the bits left), and store it into memory. In this 
chapter, you'll learn how to plot points and draw lines on the screen. You'll 
use some of the built-in capabilities of the Apple machine language monitor. 
You'll take advantage of some subroutines that are permanently stored in 
Read Only Memory (ROM). This will save you a lot of work, since these routines 
will be used over and over again in future programs. 

You have no doubt used subroutines in BASIC many times. A machine 
language subroutine works the same way, but the instructions are different, of 
course. In BASIC, you used GOSUB 2000 to tell the computer to go to the sub- 
routine located at line 2000. Then the last line of the BASIC subroutine RE- 
TURNed the computer to the main program. 

In machine language, the instruction used is: 


JSR XXXX 
M — hem cm 
Jump to ——À = HEX memory address 


SubRoutine where subroutine is 
located 


The machine language OPeration CODE for JSR is 20. 
Example of JSR as used in a program: 


779 20 ~— JSR F800 Jump to subroutine 
780 00 at memory location 
781 F8 F800 (hex) 


The last instruction used in the subroutine must be a return to the main 
program. In machine language, this would be: 


RTS (ReTurn from Subroutine) 


If you are using one of Apple's built-in subroutines, the RTS instruction is 
already there, and you don't have to worry about it. 
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PLOTTING A POINT ON THE SCREEN 


We will use three subroutines in our program to plot a point, the beginning 
step in learning to use graphics. If you have used Applesoft BASIC, you know 
that several program steps are necessary to do this. In planning our machine 


language program, we know t : 
guage program, we khow that we must BASIC Equivalent Statements 


1. Clear the screen HOME 
2. Set the Graphics mode GR 
3. Select the color to be used COLOR = 15 
4. Select the screen position of the point to C-5 
be plotted R=32 
5. Plot the point PLOT C,R 
6. Return to BASIC Operating System RETURN 


Here is a sample program to plot a point. Each function of the program is 
presented in a block that is numbered according to the above plan. The com- 
puter prints the first column. You type in the second column. 


1. REMARK ** CLEAR THE SCREEN ** 


768 20 < JSR FC58 
769 58 
710 FC 


. REMARK ** SET GRAPHICS MODE ** 


771 20 -— JSR FB40 
772 40 
773 FB 


. REMARK ** SELECT COLOR ** 


774 A9~- LDA FF 
775 FF 


776 85 < STA 0030 
777 30 


. REMARK ** SCREEN POSITION ** 


778 АО = LDY 05 
779 05 


780 А9 < LDA 20 
781 20 


. REMARK ** PLOT THE POINT ** 


782 20 < JSR F800 
783 00 
784 F8 


. REMARK ** RETURN TO BASIC ** 


785 60 < RTS 
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Jump to the subroutine 
at FC58. A built-in sub- 
routine 


Jump to the subroutine 
at FB40. Another built- 
in subroutine 


Load accumulator with 
color value = 15 or F in 
HEX (both bytes). 
Store in memory at lo- 
cation 0030 


Load the Y register 
with column number, 5 


Load the accumulator 
with row, 32 (20 HEX) 


Jump to the subroutine 
at F800. Another built- 
in subroutine. 


Return to BASIC Oper- 
ating System 


Notice the store instruction (85 HEX) at memory location 776. Ordinar- 
ily, a load from or store to a memory location requires two additional bytes to 
give the full memory address. The 6502 central processor unit recognizes the 
code 85 as a special instruction that will supply only the Least Significant Byte 
of the address. The computer “understands” that the Most Significant Byte of 
these special Zero Page instructions is zero. Hence, they are called Zero Page in- 
structions. They can be executed faster than those where à two-byte address is 
needed. 

The operation of this program is dependent upon the correct performance 
of the subroutine at location F800 that plots the point. Steps 3 and 4 of the pro- 
gram supply values that must be used by the point-plotting subroutine. 


STEP 3 — Puts the color value (0-15) into memory location 0030. Note that this 
store instruction STA uses only the last part of the address (the first part 
00 is not needed). The color value is given at program location 775. The 
color values are entered as HEX numbers O through F (0 through 15 in 
decimal numbers). The correct HEX digit must be entered in both bytes. 


Example: 

Orange: A9 LDA 99 
99 
85 STA 30 9 in both 
30 HEX digits 


The color values are given in the following table. 
COLOR TABLE 


Color HEX 
Value . Value 


Black 
Magenta 

Dark blue : 
Light purple 
Dark green - 
Grey | 
Medium blue 
Light blue | 
Brown 
Orange 

Grey 

Pink 

Green 

Yellow 
Blue/green 
White 


о CONIA RW м © 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 


=з м мз lo 
сл BW DO о 


74 


When the PLOT-THE-POINT subroutine is executed, it looks for the color 
value in memory location 0030. Therefore, the machine language program must 
store the color value there (which it does at program locations 776 and 777). 

The subroutine must also be told where to plot the point on the video 
screen. This information is supplied in Step 4 of the program. 


STEP 4 — Provides the column and row where you desire the point to be plotted. 
In low resolution graphics, these values may range from 0 through 39 in- 
clusive. The column is loaded into the Y register (a special storage location 
used by several machine instructions — 8 bits long). The row is loaded into 
the accumulator. Remember that these are machine language instructions; 
hence the values must be in HEX format. 


STEP 5 — The PLOT-THE-POINT subroutine looks at the Y register and the ac- 
cumulator to find the row and column where the point is to be plotted. 
The subroutine then plots the point. 


Accumulator | -«—— — Row for the point 


Index Register Y -«——— Column for the point 


Other controls and registers 


STEP 6 — After the point has been plotted, the Return from Subroutine instruc- 

tion returns the program to the BASIC Operating System at the point fol- 
lowing the CALL S instruction at line 800 (see Operating System, Chap. 
2). | 


The subroutines at Steps 1 and 2 merely clear the screen and set the low 
resolution Graphics mode so that the points may be plotted. 

For this program, it would be convenient to be able to change the color 
value, the column of the plot, and the row of the plot. To do this easily, add 
these lines to the BASIC Operating System Program. 
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810 INPUT "WANT TO CHANGE DATA (YES OR NO)?" A$ 
820 IF A$ = "YES" GOTO 420 


Then, when you want to change values after a run, you can change the COLOR 
value at 775, the Column at 779, or the Row at 781. This change saves you the 
trouble of typing the complete program again. 


Here is a sample display just after entry. 
HERE IS YOUR PROGRAM 


768 20 -4—— Ноте cursor and clear screen 
769 58 

770 FC 

771 20 -—— Set Graphics mode 
172 40 

773 FB 

774 A9  -—- Select color 

715 FF 

776 85 < Store color value 
171 30 

778 АО -—— Column 

179 05 

780 А9 -—— Row 

/81 20 

782 20 -—— Plot the point 

783 00 | 

784 F8 

785 60 | -—— Return 

IF ANY CHANGES- TYPE ADDRESS 
IF NOT — TYPE 99 


?m 


18 
bytes 


Here is the display after the run. 


White point plotted 
at column 5, row 32 
D 
WANT TO CHANGE DATA (YES OR NO)?m 
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Now change the color to 3 (light purple), the column to 14 (HEX), and 
the row to 14 (HEX). This would put a light purple point at the center of the 
screen. After typing YES to the question for data, the display shows: 


0 


WANT TO CHANGE DATA (YES OR NO)?YES 
4 lines IF ANY CHANGES—TYPE ADDRESS 


of text" || IF NOT — TYPE 99 
| ?m | 


Type: 775 and press RETURN. The bottom 4 lines of text now show: 


IF ANY CHANGES—TYPE ADDRESS 

IF NOT — TYPE 99 
2775 

775 DATA=28 


Type: 33 and press RETURN. The bottom 4 lines now show: 


IF NOT — TYPE 99 
2775 | 
715 DATA-?33 

ANY OTHER CHANGES (YES OR NO)?u 


Type: YES and press RETURN. The 4 lines now show: 


ANY OTHER CHANGES (YES OR NO)? YES 
IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 | 


7m 
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Type: 779 and press RETURN. The 4 lines show: 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 

?779 

779 DATA-?m 


Type: 14 and press RETURN. The 4 lines show: 


IF NOT — TYPE 99 

?779 

779 DATA=?14 | | 
ANY OTHER CHANGES (YES OR NO)?m 


Type: YES and press RETURN. The 4 lines show: 


ANY OTHER CHANGES (YES OR NO)? YES 
IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?m 


Type: 781 and press RETURN. The 4 lines show: 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 

?781 

781 DATA-?s 


Type: 14 and press RETURN. The 4 lines show: 


IF NOT — TYPE 99 

?781 

781 DATA=?14 

ANY OTHER CHANGES (YES OR NO)?® 
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Type: NO and press RETURN. Your program spins by on the four lines at the 
bottom of the screen and ends up at: 


783 00 
784 F8 
785 60 
ANY OTHER CHANGES (YES ОВ NO)?& 


Type: NO and press RETURN. The 4 lines show: 


785 60 
ANY OTHER CHANGES (YES OR NO)?NO 
PRESS ANY KEY TO RUNE 


Type: Any key that you desire to see your newly plotted point. 


New light purple point 
n "M" near the center of the screen 


WANT TO CHANGE DATA (YES OR NO)? 


Now it's up to you. If you want to plot some points in other colors 
and in other places, type YES and repeat the process. If you have had enough, 
type NO and the computer will return to the BASIC Operating System. You 
will then be ready to enter the next program. 


FOUR-CORNER PLOT 


Before we leave the point plotting technique, let's write a program to put a 
point at each corner of the graphics area. The points would be: 


Upper left 
Lower left 
Upper right 
Lower right 


79 


08 


JouJ05 14814 JAMO] 3014 OC v6. 
JO03e|nuunooe и мол peojay бу Z6L 


SLURS BY} MOJ LA| ‘ишпјоо uey) OV 06L 


190100 3j9| 4ƏMO| 3014 OZ LY 


QUIS oq ишпјоо ILI ‘MOI ә8иРц) бү SQL 


J9uJ02 149] Jaddn 30]d OZ «ZBL 
Омо  6V 08L 

Quun|o) OV 8LL 

ОЄ00 ЧІ 1 97035 — $8 OLL 


ALIHM dd SLL 
40j09 1929 бү vLL 


әрош saiydeig 195 OZ LLL 


мәә/25 oui 4LAD OZ 89L 


WVaDOdd 1074 YANYOD-ANOA 


"julod peuonippe цовә ој әоио ‘pazeada әд JIM Ç pue p 5и013295 
4247 әд {JIM uondeoxe әчү 'euo 352ү 9uj 03 Jepus eq {JIM wesosd әчү 


4. 797 A9 Change row, leave column the same 
798 00 


799 20 Plot upper right corner 
800 00 
5. | 801 F8 
802 60 Return to BASIC Operating System 


This is the longest machine language program that you have had so far. 
There are 35 bytes. When the program has been completely entered, the com- 
puter will display the first 20 lines as follows: 


HERE IS YOUR PROGRAM 


768 20 
769 58 
770 FC 
771 20 
772 40 
773 FB 
774 A9 
775 FF 
776 85 
777 30 
778 АО 
779 00 
780 A9 
781 00 
782 20 
783 00 
784 F8 
785 A9 
786 27 
787 20 
PRESS ANY KEY TO CONTINUE 
п 


Do not make any changes yet, but make a note of any errors in the first 20 lines. 
You will have your chance for corrections after the entire program has been 
displayed. 

To look at the rest of the program, press any key. The computer will clear 
the screen and display the next 20 lines if there are that many. This is what you 
will see this time: 
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788 00 
789 F8 
790 AO 
791 27 
792 A9 
793 27 
794 20 
795 00 
796 F8 
797 A9 
798 00 
799 20 
800 00 
801 F8 
802 60 
PRESS ANY KEY TO CONTINUE 


You can see now that the complete program has been displayed. When you 
press any key on the keyboard, you will see your chance for corrections. The 
lines following PRESS ANY KEY TO CONTINUE are: 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 
?m 


Type: 99 if there are no changes. 
The program then says: PRESS ANY KEY TO RUN 
Type: Any key and you will see: | 


Points in all four 
corners of the 
graphic area 


Once again you can add temporary lines to the BASIC Operating System pro- 
gram to let you change values. | 
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DRAWING A HORIZONTAL LINE 


If you can plot a point, you can draw a line by plotting a series of points. 
In the last program, it took quite a long program just to draw four points. For- 
tunately, the Apple Machine Language Monitor contains a built-in subroutine 
that will draw a horizontal line. All we have to do is store the row of the last 
point of the line in memory location 002C where the line-drawing subroutine 


can find it. | 
The subroutine used in Step 6 below is equivalent to the Applesoft BASIC 


statement: 


HLIN 16,32 AT 20 


Here is the entire program laid out in functional sections. 


HORIZONTAL LINE PROGRAM 


1. REMARK ** CLEAR THE SCREEN ** 
768 20 JSR FC58 Built-in subroutine 
769 58 | 
770 FC 

2. REMARK ** SET GRAPHICS MODE ** 
171 20 JSR FB40 Built-in subroutine 
172 40 
173 FB 


3. REMARK ** SET COLOR ** 


774 A9 LDA FF Load white color 
775 FF | 

776 85 STA 30 Store іп 0030 
777 30 | 


4. REMARK ** GIVE END POINT ** 


778 A9 LDA 20 End point at 20 (32 decimal) 
779 20 

780 85 STA 2C Store in 002C 

781 2C 
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5. REMARK ** GIVE START POINT ** 


782 AO LDY 10 Start point at 10 (16 decimal) 
783 10 

784 A9 LDA 14 Load accumulator with 

785 14 row 14 (20 decimal) 


6. REMARK ** PLOT THE LINE ** 


786 20 JSR F819 Built-in subroutine 
787 19 
788 F8 


7. REMARK ** RETURN TO BASIC ** 


789 60 RTS Return to Operating System 


If you compare this program with the original PLOT-THE-POINT program 
shown earlier in this chapter, you will find that they are very similar. In our new 
program, we must give the end value (column) before plotting the line. The sub- 
routine to plot the line is located at a different memory location than the one 
that plotted a point in the old program. 

After you have entered the program by i means of the BASIC ee 
System, the program is displayed as usual. There are 22 bytes starting at memory 
location 768. 


HERE IS YOUR PROGRAM 


768 20 
769 58 
770 FC 
771 20 
772 40 
773 FB 
774 A9 
775 FF 
776 85 
777 30 
778 A9 
779 20 
780 85 
781 2C 


PRESS ANY KEY TO CONTINUE 
B 
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. Check for correctness. Then press any key. 


788 F8 
789 60 
PRESS ANY KEY TO CONTINUE 


After pressing a key: 


788 F8 
789 60 
PRESS ANY KEY TO CONTINUE 
IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?m 


If all is correct, you type 99. 


788 F8 
789 60 
PRESS ANY KEY TO CONTINUE 

IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 

?99 


PRESS ANY KEY TO RUN 
и 


Now when you press a key, you see: 


White bar iri row 20 
(decimal) 

from column 16-32 
(decimal) 


Once again, you may want to make some changes. The lines you used be- 
fore would work well in the Operating System. 


810 INPUT “WANT TO CHANGE DATA (YES OR NO)?”; A$ 
820 IF A$=“YES” GOTO 420 
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If these lines are used, the program will display the line and then let you change 
the data in any address that you want. If lines 810 and 820 are in the Operating 
System, it will be easy to change from the HORIZONTAL LINE PROGRAM to 


the next program that draws vertical lines. 


DRAWING VERTICAL LINES 


The Clear Screen, Set Graphics, and Set Color sections of the Horizontal 
Line Program will also work for the Vertical Line Program, so we will leave them 
as they are. 

Section 4, the Give-End-Point routine, requires that we change only the 
storage location of the vertical end point. This will now be stored in location 
002D instead of 002C as in the Horizontal Line Program. The subroutine that 
draws vertical lines looks for its end point at 002D. This will require that we 
change the value stored in program memory location 781. 

Section 5 of the Horizontal Line Program gave the beginning point of the 
line (the column where the line started). It also gave the row in which the hori- 
zontal line was to be drawn. You must change the beginning point of the hori- 
zontal line to the column at which the vertical line will begin. To do this, change 
the value stored in program memory location 783. You must also change pro- 
gram memory location 785, which did contain the row in which the horizontal 
line was drawn. This must now be changed to the starting row at which the ver- 
tical line will be drawn. 

Section 6 must also be changed. Instead of jumping to the subroutine that 
draws a horizontal line, you must jump to the subroutine that draws a vertical 
line. You need only to change program memory location 787. 


Here is a summary of the four changes: 


Change 781 from 2C to 2D Storage for End Point 

Change 783 from 10 to 14 Column for the line 

Change 785 from 14 to 10 Start point of line 

Change 787 from 19 to 28 Address of subroutine F828 
instead of F819 


The subroutine at memory location F828 is equivalent to the BASIC 
statement: 


VLIN 16,32 AT 20 
If lines 810 and 820 have been added to the Operating System and the 


Horizontal Line Program has been run, the computer will end with the question 
that asks for changes. 
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WANT TO CHANGE DATA (YES OR NO)?s 


Type: YES and press RETURN. The four bottom lines show: 


WANT TO CHANGE DATA (YES OR NO)? YES 
IF ANY CHANGES—TYPE ADDRESS 
IF NOT — TYPE 99 


?m 
Type: 781 and press RETURN. 


IF ANY СНАМСЕЅ TYPE ADDRESS 
IF NOT — TYPE 99 

2781 

781 DATA-?w 


Type: 2D 7*— — Memory location where end point is stored 


IF NOT — TYPE 99 

?781 

781 DATA=?2D 

ANY OTHER CHANGES (YES € OR NO)?= 


Type: YES and press RETURN. 


ANY OTHER CHANGES (YES OR NO)?YES 
IF ANY CHANGES- TYPE ADDRESS — 
IF NOT — TYPE 99 


7a 
Type: 783 and press RETURN. 


IF ANY CHANGES—TYPE ADDRESS 
IF NOT — TYPE 99 

2783. ! 

783 DATA-?w 


Туре: 14 | -—— ———- Column of line 


IF NOT — TYPE 99 

?783 

783 DATA-?14 

ANY OTHER CHANGES (YES OR NO)?a 
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Type: YES and press RETURN 


ANY OTHER CHANGES (YES OR NO)? YES 
IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?m 


Type: 785 and press RETURN 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 

2785 

785 DATA-?m 


Type: 10 4—— Start point of line 


IF NOT — TYPE 99 

2785 | 

785 ОАТА=?10 

ANY OTHER CHANGES (YES OR №О)?ш 


Type: YES and press RETURN 


ANY OTHER CHANGES (YES OR NO)? YES 
IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?m 


Type: 787 and press RETURN 


IF ANY CHANGES- TYPE ADDRESS 
IF NOT — TYPE 99 

?787 

787 ОАТА=?ш 


Type: 28 (00 — Address of new subroutine 
(Least Significant Byte of F828) 


IF NOT — TYPE 99 

?787 

787 DATA-?28 

ANY OTHER CHANGES (YES OR NO)? 


Type: NO 


Your program is then listed for you in two sections, as was done for the 
Horizontal Line Program. 
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When you RUN the program, you will see: 


4— . White vertical line 
in column 20 from 
row 16-32 


WANT TO CHANGE DATA (YES OR NO)? 


If you want to experiment with the Vertical Line Program, make your 
changes at this time and try the program again. You will soon be an expert in 
plotting points and drawing lines at any place you wish on the screen. Practice 
so you will be ready for a program that will join lines together to form a rec- 


tangle. 


DRAWING A RECTANGLE 


Since you know how to draw horizontal and vertical lines, you will be able 
to draw a rectangle by joining pairs of lines together. The program that follows 


will draw the rectangle shown. 
/ — Column 


5,5 34,5 
"E Row 


5.34 34,34 


No new instructions are used, but the program is longer (45 bytes this 
time). We'll once again show the program in sections with the mnemonic codes 


as well as the OP CODES. 
RECTANGLE PROGRAM 
1. REMARK ** CLEAR THE SCREEN ** 


768 20 JSR FC58 Jump to subroutine FC58 
769 58 
770 FC 
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2. REMARK ** SET GRAPHICS MODE ** 


771 20 JSR FB40 Jump to subroutine FB40 
772 40 

773 FB 

. REMARK ** SET COLOR ** 

774 А9 LDA FF Load accumulator with color 
775 FF 

776 85 STA 0030 Store value in memory 0030 
777 30 


. REMARK ** END POINT FOR BOTH LINES ** 


778 A9 
779 22 


780 85 
781 2C 


782 85 
783 2D 


LDA 22 


STA 2C 


STA 2D 


End at column and at row 34 
(decimal) 


End column stored at 002C 


End row stored at 002D 


. REMARK ** START HORIZONTAL AND ROW ** 


784 AO 
785 05 


786 A9 
787 05 


LDY 05 


LDA 05 


Start of horiz. lines 


Row 5 


. REMARK ** DRAW TOP OF RECTANGLE ** 


788 20 
789 19 
790 F8 


JSR F819 


Jump to subroutine F819 


. REMARK ** RESET START AND ROW ** 


791 AO 
792 05 


793 A9 
794 22 


LDY 05 


LDA 22 


Reset start point 


Move to row 34 (dec.) 
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8. REMARK ** DRAW BOTTOM OF RECTANGLE ** 
795 20 JSR F819 Jump to subroutine F819 


796 19 
797 F8 


9. REMARK ** START VERTICAL AND COLUMN ** 


798 АО LDY 05 Column 5 

799 05 

800 A9 LDA 05 Start of vert. lines 
801 05 


10. REMARK ** DRAW LEFT SIDE ** 
802 20 JSR F828 Jump to subroutine F828 


803 28 
804 F8 


11. REMARK ** RESET START AND COLUMN ** 


805 AO LDY 22 Move to column 34 (dec.) 
806 22 

807 A9 LDA 05 Reset start point 

808 05 


12. REMARK ** DRAW RIGHT SIDE ** 
809 20 JSR F828 Jump to subroutine F828 


810 28 
811 F8 


13. REMARK ** RETURN TO BASIC ** 


812 60 RTS 
This program has 45 bytes. After you have entered it, the computer will 
display it in 3 sections (20 lines at a time). If there are mistakes, correct them. If 


not, RUN it. Here is what you will see: 


9] 


Here is your 
rectangle 


WANT TO CHANGE DATA (YES OR NO)? 


SUMMARY 


Machine language subroutines were used heavily in this chapter. The Apple 
Machine Language Monitor has several built-in programs for this purpose. You 
used the subroutines to clear the screen, to set the Graphics mode, to plot 
points, and to draw horizontal and vertical lines. 

You again used the load and store instructions to move data to locations 
where they could be found by the appropriate subroutine. 

You learned to use these instructions: 


1. JSR Jump to SubRoutine) — used in the Absolute Mode to take advantage of 
built-in subroutines to supplement your programs. 
Example: 20 OP CODE 
19 least significant address byte 
FB most significant address byte 


2. LDY (LoaD Y register) — used as a special place to store a value in the Imme- 
diate Mode. This value was used by a subroutine. 
Example: АО OP CODE 
22 data loaded in Y register 


3. STA (STore Accumulator) — used this time in the Zero Page Mode. This 
mode is only used when data is to be transferred to or from low memory 
(where the most significant byte of the memory address is zero). Memory 
from 0000 through OOFF is called zero page memory. 

Example: 85 OP CODE 
30 least significant address byte 


The machine language instructions that you have used so far in this book 
are: 
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Addressing 
Mode 


Bytes 
Used 


Mnemonic 
Code 


OP CODE 


immediate 
Immediate 
Absolute 
Zero Page 
Absolute 
Implied 


Accumulator 


The accumulator and Y register and certain memory locations were used 
to store values to be used by the built-in subroutines. Here is a summary of these 


uses. 


Subroutine Y reg. Accum. 


Column 
Start 
column 

Column 


Horizontal Line 


Vertical Line 


You are well on your way to machine language programming. In the next 


0030 


Function 


Load accumulator 

Load Y register 

Store accumulator in 
memory 

Jump to subroutine 

Return from sub- 
routine 

Shift bits left in 
accumulator 


002C 002D 


End 
column 


chapter we'll look at how to put alphanumeric characters on the video screen. 


EXERCISES 


Fill in the blanks. 
1. The mnemonic code JSR is an abbreviation of 


2. The color values used in a machine language program are two-digit HEX num- 


bers. Which of the following are within the recommended range? 


a. CC b. OH c. FG d. 33 
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. To plot a point on the screen using the built-in subroutine, these things must 
be done first. 

a. set the graphics mode 

b. select a color value 

c. load the Y register with 

d. load the accumulator with 


. What range of values may be used to plot a point in the low resolution 
graphics that we have used in Chap. 3? 

a. Column... — to ————— inclusive 

р. Row___ —..to. inclusive 


. The built-in program that draws a vertical line and the one that draws a hori- 


zontal line use .  ..  . . .. ^ .subroutine(s). 
(the same, different) 


. Explain when the Zero Page Mode instruction STA (Op Code 85) may be 
used. 


ANSWERS TO EXERCISES 


. Jump to SubRoutine 
.aandd 


. с. column number (0-27 HEX) 
d. row number (0-27 HEX) 


. a. column 0 to 39 decimal (or 0 to 27 HEX) 
b. row 0 to 39 decimal (or 0 to 27 HEX) 


. Different (horizontal line at F819, vertical line at F828) 


6. When data from the accumulator is to be stored in zero page memory (0000 


through OOFF). The most significant byte is OO and is unneccessary for a 
Zero Page Mode instruction. 
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Chapter 5 


Displaying Text 


The video display is a window through which you may see what the com- 
puter is doing. The screen can display the contents of certain memory locations. 
In Chap. 4, you displayed graphics on the screen by using the computer's sub- 
routines. In this chapter, you will learn how to place text directly into the video 
display's memory area so that messages can be seen on the screen. 

You will be introduced to some new instructions that will be used to form 
a loop similar to IF-THEN and FOR-NEXT loops that you have used in BASIC. 

The computer has two registers that can be used as “counters.” These 
counters (the X register and the Y register) can be used to /ndex, or count, the 
number of times the computer executes a loop. They can also be used to index 
the memory locations from which data is loaded or to which data is stored. 
This operation leads to the use of a new addressing mode called Absolute In- 
dexed Addressing. 


DISPLAYING A CHARACTER 


We'll start with a simple program that will display the letter A in the 
upper left corner of the screen. You have used all the instructions that appear 
in this program. The only new item is the use of ASCII codes. Since the com- 
puter can understand only numerical instructions and data, all alphabetic and 
punctuation characters (as well as certain other special characters) must be given 
in numerical form. ASCII codes are used for this purpose. (A complete list of 
codes is given later in this chapter.) 


DISPLAY ONE LETTER PROGRAM 
1. REMARK ** CLEAR SCREEN ** 


768 20 JSR FC58 Jump to subroutine 


769 58 
770 FC 
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2. REMARK ** SELECT LETTER 'A' ** C1 is the HEX code for 


an «AP 
771 А9 LDACI™ Load accumulator with ASCII code 
772 C1 for A | 
3. REMARK ** DISPLAY IT ** 
773 8D STA 0400 Store it in display's memory area 
774 00 
775 04 
4. REMARK ** RETURN TO BASIC ** 
776 60 RTS Return to Operating System 


You have seen Section 1 before. It is the built-in subroutine that clears 
the screen. 

In Section 2, the ASCII code for the letter A (HEX value C1) is loaded 
into the accumulator. Other values would give other characters. 

Section 3 uses the Absolute Addressing Mode for the STA instruction. 
The location of this memory element (0400 HEX) is the upper left corner of the 
display. 


Section 4 returns to the BASIC Operating System. 


Enter the program using the BASIC Operating System. Then, RUN the 
short machine language program. You will see the letter A appear in the upper 
left corner of the screen. The blinking cursor will indicate that the program has 
returned to the Operating System. 


The display: 
A 
j= 


Next comes a program that will display an alphabetic character several 
times across the top of the screen. You may want to experiment with this pro- 
gram. Add these lines to the BASIC Operating System: 


810 PRINT: PRINT 
820 INPUT "WANT TO CHANGE DATA (YES OR NO)?"; A$ 
830 IF A$-"YES" THEN 420 


Then, use the Operating System to enter this program. Do not enter the RE- 
MARKS, Mnemonic Codes, or Operands. 
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Example: 
1. REMARK ** CLEAR SCREEN ** 


JSR FC58 Clear the screen 


BN DO NOT ENTER THESE 


Computer Y ou enter 
prints these these 


Only the address and data are entered. The rest of the notes and comments are 
just to help you understand the function of each program section. The program 
contains 16 bytes. 


CHARACTER DISPLAY PROGRAM 
1. REMARK ** CLEAR SCREEN ** 


768 20 ЈЅЕЕС58 Clear the screen again 
769 58 
770 FC 

2. REMARK ** SET INDEX TO ZERO ** 


771 AO ШУО Used to index display memory and to 
772 00 exit loop 


3. REMARK ** SELECT CHARACTER ** 


773 A9 LDACI Load an A, just like the last program 
774 C1 


4. REMARK ** HERE IS THE LOOP ** 


775 99 .STA 0400, Y Store in memory location 0400+con- 
776 00 tents of Y register 


777 04 

778 C8 INY Increment Y register for next location 
Loop 

779 CO СРҮ 28 Compare Y with 40 (decimal) 

780 28 


DO BNEF8 Branch (if the two values are not equal) 
F8 to location 0775 
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5. REMARK ** RETURN TO BASIC ** 
783 60 RTS 


Let's now go through the program section by section. We will discuss the 
instructions used and what each does when the program is run. 

The screen is cleared in Section 1. This subroutine will be used in most, if 
not all, of our programs. 

In Section 2, the Y register is loaded with the value zero. The LDY instruc- 
tion was discussed in Chap. 4. For this program, the Y register is used to keep 
track of how many times the loop in Section 4 is performed. We set it to zero in 
preparation for the counting process. 


Y register 00000000 (in binary) 


In Section 3, the LDA instruction is used in the Immediate Mode to load 
the HEX value C1 into the accumulator. This value will be used to display the 
letter A in Section 4 of the program. 


Accumulator 11000001 (in binary) 


A complete set of ASCII codes is given in the Appendix. C1, the code for the 
letter A, is the only ASCII code used in this program. 

Section 4 forms the loop that prints the letter A at each position along the 
top line of the video display. The loop works this way: 


First time through the loop: Y register = 0 


1. The STA instruction stores the code for A in memory location 040040 (1st 
position, top line). Notice that the value stored in Y (0 at this time) is added 
to the value 0400 to determine the memory location used for storage. 


2. The INY instruction (Operation Code = C8) increments the value held in the 
Y register by one. Therefore, the Y register now holds a value of 1. 


3. The CPY instruction (Operation Code - CO) compares the value in the Y 
register (now 1) with the HEX value 28 (the second byte of the instruction). 


4. The BNE instruction (Operation Code = DO) will cause a branch back to the 
beginning of the loop if the two values compared in Step 3 are not equal. 
Since 1 and 28 are not equal, the computer returns to the beginning of the 
loop this time. If the values were equal, the computer would go on to Section 
5 of the program. 

Second time through the loop: Y register = 1 

1. The STA instruction stores the A in the memory location 0400-1 (0401 is 
the 2nd position, top line). 

2. The Y register is incremented by the INY instruction and now holds a value 
of 2. 


3. The value of 2 in the Y register is compared to the value 28. 
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4. Since 2 does not equal 28, the BNE instruction once again sends the com- 
puter back to the beginning of the loop. 


Third time through the loop: Y register = 2 


etc. 


Each time through the loop, the character A is printed one place to the 
right of the preceding position. 


Fortieth time through the loop, Y = 27 HEX 


1. The STA instruction stores A in the last position on the top line (0400427). 
2. The Y register is incremented to 28. 
3. The content of the Y register is compared to 28 HEX. 
4. Since Y = 28, do not branch back. Go on to the next instruction, which is in 
Section 5. 
Section 5 returns the computer to the BASIC Operating System, where 
you are asked if you want to change data. 


Since the Apple computer displays 40 characters on each line, you will see 
40 A's on the screen. 


AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 


WANT TO CHANGE DATA(YES OR NO)?# 


DISCUSSION OF THE NEW INSTRUCTIONS 


The first new instruction encountered in the program was: 


99 STA 0400,Y 


OP CODE Operator Index 


This instruction is an Absolute Indexed Address instruction and is similar to the 
Absolute Address store instruction. However, this new instruction adds the con- 
tent of the Y register to the absolute value of the address used. 


p asd Absolute address 


STA 0400, Y4— Index 


Example: 


If Y=0, STA 0400+0 is equivalent to STA 0400 
If Y=1, STA 0400+1 is equivalent to STA 0401 
lf Y=27, STA 0400+27 is equivalent to STA 0427 
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Thus we have a way to make the store instruction store in different loca- 
tions each time the loop is executed. 


In the previous program you have discovered that the top line of the dis- 
play screen is assigned consecutive memory locations, 0400 through 0427, in- 
clusive. 


Topline | AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 
memory 
locations | 0400 0401 0402 ....@1с.1о......... 0427 


The INY instruction at program memory location 778 is an Implied Ad- 
dressing instruction that increases the value of the Y register. It is similar to the 
BASIC instruction Y = Y + 1, and is used to increment the memory location for 
storing the character A on the display each time through the loop. 

The CPY 28 instruction is used here in the Immediate Addressing Mode. 
The current value of the Y register is compared to the HEX value 28. This com- 
parison enables the computer to make a decision in the next step as to whether 
or not to return to the start of the loop. Together with the BNE instruction, 
CPY performs a similar function to the BASIC statement: 


IF N< 228 THEN GOTO XX (where XX is the line that will be 
branched to) 


The final new instruction, BNE F8, requires some explanation. It is a 
Relative Addressing instruction that completes the loop. 


BNE F8 Branch if Not Equal -8 locations 
Ee — 


If the result of the preceding instruction (CPY 28) is not zero, a hranch is taken 
back to the beginning of the loop. The branch is made to a memory location 
relative to the position of the program counter. The value F8 HEX is equivalent 
to the negative number -8, and will cause a branch backwards 8 steps from the 
current position of the program counter. 

When used as the operand in a branch instruction such as BNE, all HEX 
values from 01 through 7F inclusive cause a branch forward from the current 
position of the program counter. The following instruction would cause a branch 
forward from memory location 783 (where the program counter points as the 
BNE instruction is executed) to memory location 78B (78348). 


781 DO BNE 08 
782 08 
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An example of the above as used in a section of a program follows. 


779 CO CPY28 Compare the value of the Y register 


780 28 with 28 HEX 
781 00 BNEOS  Branchif Y is not equal to 28 
Program 782 08 forward 8 steps 
counter | r> 783 
starts 784 
here i 785 
i 786 
| 787 
Вгапсһ | 788 
forward | 789 
8 steps | 78А 
if Y —> 78B 
not = 28 78C 


All HEX values from 80 through FF are used by branch instructions as 
backward (or negative) branches. In the Character Display Program, the instruc- 
tion used is: 


781 DO BNE F8 Branch if Y is not equal to 28 back- 
782 F8 ward 8 steps 


The branch is made backwards (or in the negative direction) since F8 is between 


80 and FF. Counting back 8 steps from location 783 puts the branch destina- 
tion at 775, the start of the loop. 


— > 775 99 5ТА 0400,Ү 


\ 776 00 
branch 777 04 
back 8 ' 778 C8 INY 
' 779 CO СРҮ28 
! 780 28 
! 781 DO BNEF8 
! 782 F8 
L783 60 RTS 
Program 


Counter here 
when BNE is executed 


We will not go into the method used by the computer to determine the 
values of negative numbers. Instead, we will provide tables to determine the 
operand used with branch instructions. 
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TABLE TO DETERMINE FORWARD BRANCHES 


102 


Examples Using Forward Branches: 
1. 


a ж» ж» шз кэ шэ ше з e 


792 DO BNE 07 


793 07 


з 
O 
I 


«абе» — eee] ш» 


—801 . 


Program counter starts at 794 
Branch desired to 801 (7 steps) 


Look up in table: 


Steps Branch 

Forward Operand 

(Decimal) (HEX) 

7 07 <—— Operand 


If condition tested is not equal to zero, branch forward to 801 


(794+7 steps). 


798 00 BNE TF 


799 1F 


* i 
о 
о 


Qo ж» ше тз эз = = 


—9831 . 


Program counter starts at 800 
Branch desired to 831 (31 steps) 


Look up in table: 


Steps Branch 

Forward Operand 

(Decimal) (HEX) 

31 1F -«—— — — Operand 


If condition tested is not equal to zero, branch forward to 831 


(80031 steps). 


814 DO . BNE 77 


oo 
aun 
oO 


— 935 . 


Program counter starts at 816 
Branch desired to 935 (119 steps) 


Look up in table: 


Steps Branch 

Forward Operand 

(Decimal) (HEX) 

119 77 -—— —— — Operand 


If condition tested is not equal to zero, branch forward to 935 


(8164119 steps). 


922 DO BNESB 


923 5B 


O 
N 
A 


a 


-à * 
eo 
— 
сл 


Program counter starts at 924 
Branch desired to 1015 (91 steps) 


Look up in table: 


Steps Branch 

Forward Operand 

(Decimal) (HEX) 

91 5B -—— —— — Operand 


If condition tested is not equal to zero, branch forward to 1015 


(924491 steps). 
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TABLE TO DETERMINE BACKWARD BRANCHES 


Branch 
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Examples of Backward Branches: 


1. 


; Program counter starts at 782 
je 715 Branch desired to 775 (-7 steps) 
ME 
i Look up in table: 
i Steps Branch 
a Backward Operand 
! 780 DO BNEF9 (Decimal) (HEX) 
|! 781 F9 7 F9 -«———— Operand 
> 782. 
If condition tested is not equal to zero, branch backward to 775 
(782-7 steps). 
А Program counter starts at 809 
^ud 778 Branch desired to 778 (-31 steps) 
[| . 
| Look up in table: 
| Steps Branch 
Ps Backward Operand 
1 807 РО BNEEI (Decimal) (НЕХ) 
808 E1 31 E1 «————— Operand 
> 809 . 
If condition tested is not equal to zero, branch backward to 778 
(809-31 steps). 
: Program counter starts at 900 
Г 781 Branch desired to 781 (-119 steps) 
| 
i Look up in table: 
: Steps Branch 
| А Backward Operand 
1 898 DO BNE 89 (Decimal) (HEX) 
ı 899 89 119 89 ~——— Operand 
‘> 900 | 


If condition tested is not equal to zero, branch backward to 781 
(900-119 steps). 


705 


4. Program counter starts at 886 


j^» Branch desired to 795 (-91 steps) 

[| 

i Look up in table: 

! Steps Branch 

АР Backward Operand 

i 884 DO BNE A5 (Decimal) (НЕХ) 

! 885 А5 91 А5 «<——Operand 
> 886 


While you have the program in the computer, experiment by changing 
the ASCII values used at memory address 774. Use the values C1 through DA to 
see different letters of the alphabet. When you have finished experimenting, the 
next program displays all the 26 alphabetic characters on one line. 


We have now talked about these parts of the 6502 microprocessor. 


Program counter 


“~~ Keeps track of where 
the computer is in a 
program 


Other controls and registers 


RUNNING THROUGH THE ALPHABET 


In the previous program STA 0400, Y was used to place a letier in consec- 
utive positions on the top line of the video display. The Y register was used to 
index the position. 

The X register can be used in the same way. If the ASCII codes for the let- 
ters of the alphabet are stored in consecutive memory locations, they can be 
loaded into the accumulator by the instruction: 
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LDA 0314,X ac 
Load the from Absolute + contents of 
accumulator Address 0314 X register 


Either of the two registers (X or Y) may be used with the STA instruction or the 
LDA instruction. They may also be used with other instructions, as we will see 
later. 

After each ASCII code is accessed in the program, the X register can be in- 
cremented to provide the correct code for the next pass through the loop. By 
adding a new section to the previous program, you can access each alphabetic 
character in order while displaying it in a new position on the screen. 


RUNNING ALPHABET PROGRAM 
1. REMARK ** INITIALIZATION ** 
768 20 JSR FC58 Clear the screen 
769 58 
770 FC 


771 АО LDY О 
772 00 


773 A2 LDX 0 New instruction — load X register with 
774 00 zero 


2. REMARK ** LOAD AND DISPLAY LOOP ** 

775 BD LDAO314,X New instruction — load accumulator 
716 14 from 0314+X 

771 03 


778 99 | STA 0400,Y 


779 00 
780 04 
Loop 781 E8 ІМХ New instruction — increment the X 
register 
782 C8 INY 
783 CO СРҮ1А 1A hex = 26 (the number of letters in 
784 1A alphabet) 
785 DO BNE F4 Branch if not =, back 12 locations (F4 
786 F4 from table) 
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3. REMARK ** BACK TO BASIC ** 


787 


60 


RTS 


4. REMARK ** DATA LIST ** 


788 
789 
790 
791 
792 
793 
794 
795 
796 
797 
798 
799 


C1 

C2 
C3 

C4 
C5 
C6 
C7 
C8 
C9 
CA 
CB 
CC 


800 CD 


801 
802 
803 
804 
805 
806 
807 
808 
809 
810 
811 
812 
813 


CE 
CF 
DO 
D1 

D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
DA 


Letter A ASCII codes 
Letter B 
Letter C 


Letter Y 
Letter Z 


Section 1 initializes the X and Y registers to zero. 
Section 2 loads an ASCII character from memory and displays it on the 


top line. 


ASCII CODE ACCUMULATOR |—»*»| DISPLAY 
} to to 


From memory 


screen memory 


The LDA 0311,X instruction is similar to the BASIC READ statement. The 
ASCII code is READ from the DATA stored in memory. Section 2 is a loop that 
is executed 26 times (one for each letter of the alphabet). 

Section 3 returns control to the BASIC Operating System after the RUN is 


completed. 
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Section 4 provides the DATA to be READ by the LDA 0314,X instruc- 
tion. This section is used like the DATA statement in BASIC. 

Use your BASIC Operating System to load and run the program. The pro- 
gram begins at memory location 768 and is 46 bytes long. Here is how the 
display looks after the program is run. 


ABCDEFGHIJKLMNOPQRSTUVWXY Z 


WANT TO CHANGE DATA (YES OR NO)?uw 


Y ou have learned how to display information on the top line of the screen. 
In the next program, you will use a built-in subroutine that will let you type in 
characters from the keyboard. It will display the ASCII codes that are used to 
represent the letters of the alphabet. 


A B C 


DISPLAYING ASCII CODES 


This program uses a built-in subroutine (JSR FD35) that reads a character 
you have typed on the keyboard. It puts the ASCII code for that character in 
the accumulator. 

Another subroutine (JSR FDDA) is used to print the ASCII code for the 
character you have typed. The program is designed to let you input all 26 alpha- 
betic characters from the keyboard before returning to the BASIC Operating 
System. Spaces and carriage returns are provided in the program so that the 
typed characters and the ASCII codes will be clearly shown in columns along the 
left side of the screen. There are 41 bytes. 


DISPLAY ASCII CODES PROGRAM 
1. REMARK ** CLEAR SCREEN AND INITIALIZE ** 


768 A2  LDXO Set counter 
769 00 
770 20 JSR FC58 Clear screen 
771 58 
772 FC 


X register = 
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2. REMARK ** GET KEYSTROKE AND PRINT ** 


Start 
773 20  JSRFD35 Get keystroke 
774 35 
775 FD 


776 SD = STA 0340 Save it in memory 
777 40 
778 03 


779 20 JSR FDED Print it 
780 ED 
781 FD 


3. REMARK ** SPACE DISPLAY ** 


782 A9 LDAAO Load ASCII code for a space 

783 AO 

784 20 JSR FDED Display the space. The subroutine uses 
785 ED the accumulator for other things so if 
786 FD we want another space we 9 

787 A9 | LDA AO Load another space 

788 AO 

789 20 JSR FDED Display it 

790 ED 

791 FD 


4. REMARK ** PRINT ASCII CODE ** 


792 AD LDA 0340 Load accumulator from memory 
793 40 where character was saved 

794 03 

795 20 JSRFDDA Print the code as two hex digits 
796 DA 

797 FD 


170 


5. REMARK ** MOVE TO NEW LINE ** 


798 A9 LDASD Load an ASCII code for a carriage re- 
799 8D turn 

80020  JSRFDED Do a carriage return 

801 ED 

802 FD 


6. REMARK ** BRANCH BACK IF NOT DONE ** 


803 ЕЗ INX Increase counter (X register) 
Loop 804 ЕО CPX1A Compare X register with 26 (dec) 
to 773 805 1A 
for new 
key- 806 DO BNE DD If not equal, branch back 35 steps (DD 
stroke 807 DD from Table to Determine Backward 


| Branches) 


7. REMARK ** RETURN TO BASIC ** 


808 60 RTS Return from this subroutine to the 
Operating System 


Section 1 sets the X register (counter for the number of keystrokes) to 
zero and clears the screen. 

Section 2 uses the subroutine at FD35 to read the character that is typed. 
The character is then saved in memory 0340 for future use in section 4. The sub- 
routine at FDED then prints the character on the screen. 

Section 3 provides two spaces between the character that was typed and 
the ASCII code that will be printed in section 4. The ASCII code for space is 
EO. 

Section 4 loads the accumulator with the character that was saved in 
memory 0340 in section 2. It then uses the subroutine at FDDA to print the 
character as two HEX digits (the ASCII code for the character). 

Section 5 provides a carriage return (ASCII code 8D) so that the next 
keystroke and code will appear on a new line. 

Section 6 increases the counter (register X), compares its value with 26 
(since there are 26 letters in the alphabet), and branches back to get a new key- 
stroke if its value is not equal to 26. If it does equal 26, it moves on to section 7. 

Section 7 returns control to the BASIC Operating System. 


A suggested addition to the BASIC Operating System for this program is: 
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810 PRINT 
820 INPUT “DO YOU WANT TO RUN AGAIN (YES OR NO)?”; A$ 


830 IF A$=“YES” THEN 700 


This would allow you to repeat the program with new inputs from the keyboard. 


RUNNING THE PROGRAM 


When the program is run, you will see the blinking cursor in the upper left 
corner of the screen. This means that the computer is ready for your first entry. 


A C1 -«— — ASCII code for A 
-—— — —— Blinking cursor 


A Cl ASCII code for B 


BC24— 


B -«—— ——— Blinking cursor 


- 
< 
"O 
© 
O 


A C1 ASCII code for C 
B с 

С СЗ 

п -Blinking cursor 


Continue in this manner until you have seen all 26 character codes. 


DO YOU WANT TO RUN AGAIN (YES OR NO)?m 


If you are curious, you will type in YES and try some characters that are 
not alphabetic. Remember that the program is only fixed to let you input 26 
keystrokes before returning to the Operating System. 

You may want to try the decimal numerals O through 9, punctuation 
marks, spaces, etc. 
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Here are the results that we saw when we typed in decimal symbols. 


B о омо їл Бом — © 


You may want to make a table of ASCII codes for all the keys that you 
try. Compare them with the ASCII code table in Appendix A. 

Would you like to see the letters printed on an inverted background 
(black-on-white)? Or even blinking back and forth from black-on-white to white- 
on-black? The next program will demonstrate how to do just that. Move on 
when you are ready. 


DISPLAYING MORE THAN ONE LINE 


The last program and the next one make use of one of the Apple Monitor's 
built-in subroutines that places a character (whose ASCII code is contained in 
the accumulator) on the screen. It then moves over automatically to the next 
printing position on that line. The ASCII code for a carriage return (8D) is used 
to move to the beginning of the next line when desired. 

You will want to experiment with this program, so be sure to include lines 
in the BASIC Operating System that will allow you to change data. We will be 
using: 


810 PRINT 
820 INPUT "WANT TO CHANGE DATA (YES OR NO)?”; A$ 
830 IF A$=“YES” THEN 420 


You will want to change data because we will show you how to PRINT white 
on black, black on white, and letters blinking on and off. 


MULTI-LINE DISPLAY PROGRAM 
1. REMARK ** CLEAR SCREEN AND INITIALIZE ** 


768 20 JSR FC58 
769 58 
770 FC 


771 A2 | LDXO 
772 00 
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2. REMARK ** GET CHARACTER AND PRINT ** 


773 
714 
775 


776 
777 
778 
779 


780 
781 


782 
783 


BD 
11 
03 


20 
ED 
FD 
E8 


EO 
16 


DO 
F5 


LDA 0311,X 


JSR FDED 


INX 


CPX 16 


BNE F5 


Put character in accumulator on the 
screen 


New instruction — compares value in 
X register with 16 


Branch back if not equal (-11 loca- 
tions) 


3. REMARK ** BACK TO BASIC ** 


784 


60 


RTS 


Return to BASIC 


4. REMARK ** DATA LIST OF ASCII CODES ** 


785 
786 
787 
788 
789 
790 
791 
792 
793 
794 
795 
796 
797 
798 
799 
800 
801 
802 
803 
804 
805 
806 


C1 

DO 
DO 
CC 
C5 
8D 
C3 
CF 
CD 
DO 
D5 
D4 
C5 
D2 
8D 


Letter A 

Letter P 

Letter P 

Letter L 

Letter E 

A carriage return (new line) 
Letter C 

Letter O 

Letter M 

Letter P 

Letter U 

Letter T 

Letter E 

Letter R 

A carriage return (new line) 
Letter D 

Letter | 

Letter S 

Letter P 


Letter L 
Letter A 
Letter Y 
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Section 1 initializes the X register to zero and clears the screen. 

Section 2 loads an ASCII code from memory (indexed by X) and uses the 
built-in subroutine to display it on the screen. This section is a loop. Each time 
through, the X register is incremented so that the next ASCII code in memory 
can be loaded. The value in the X register is compared to 16 HEX (22 decimal) 
since there are 22 characters in the data list. If X is not equal to 22, a branch is 
taken back to the beginning of the loop (location 773). 

Section 4 is the data list used by the loop. 


Once again, use the BASIC Operating System to load and run the program. 
Everything begins at location 768 and is 39 bytes long. We saved a few lines by 
using the built-in subroutine to display the data. When the run is completed, the 
display will show: 


APPLE 
COMPUTER 
DISPLAY 


WANT TO CHANGE DATA (YES OR NO)?& 


This program is similar to the Running Alphabet Program. However, the carriage 
returns in the data list allowed the use of more than one line on the screen. 

Up to now, the book has shown the video display as black letters on a 
white background. Actually, your computer displays light-colored letters on a 
dark background. However, books are traditionally printed in black letters on 
white pages. Oh well, we can't all be perfect. The versatility of computers is 
amazing. Read on and you will see. 

The Apple computer has the ability to reverse the color of text material 
so that the background for an individual letter is white and the letter is black. 
This is called an inverse display. To accomplish this inverse effect, you change 
the normal ASCII code as in the following examples: 


a. ASCII code for the letter A = C1 
Inbinary: 11000001 
— —P 
C 1 
INVERSE code for the letter A = 01 
In binary: 0000000 1 
— Mc 
0 1 
b. ASCII code for the letter P - DO 
Inbinary: 11010000 


“ча —— 0 ee” 
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INVERSE code for the letter P = 10 
In binary: 00010000 


~S a ë "ERR. amans 


1 0 


To cause the character to be inverted, the two most significant bits (those in the 
two far left positions) are removed. 


[joo 0001 CI [1 1]01 0000 DO 
to or to 


00000001 01 00010000 т 


To demonstrate this feature, make the following changes to the MULTI- 
LINE DISPLAY PROGRAM. 


785 01 Inverted A 
786 10 Inverted P 
787 10x Inverted P 
788 0С Inverted L 
789 05 Inverted E 


Now, when you run the changed program, you will see this difference in 
the display. 


Original Program Changed Program 


APPLE 


Another change to the ASCII code of the character to be displayed will 
make the character blink on and off. To demonstrate, change the codes of the 
word DISPLAY. 


800 44 blinking D 
801 49 blinking | 
802 53 blinking S 
803 50 blinking P 
804 4C blinking L 
805 41 blinking A 
806 59 blinking Y 


Once again, notice the changes for the three possibilities for the letter A. 


Normal A = C1 1100 0001 in binary 
Inverse A = 01 0000 0001 in binary (left 2 digits = 0) 
Blink A а 41 0100 0001 in binary (left digit = 0) 
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Use the BASIC Operating System to make the changes in memory at loca- 
tions 800 through 806. Now when you run the program, the word DISPLAY 
will blink — first inverse, then normal, then inverse, then normal, etc. 


APPLE 
COMPUTER White on black 


DISPLAY 


Black on white 


You can change the message displayed by this program by using any letters 
in the following table at the data locations beginning at 800. You may make the 
message longer or shorter by changing the value in location 781 to match the 
number of characters used. 


CODE TABLE FOR ALPHABET 


NORMAL INVERSE BLINK LETTER 
C1 01 41 A 
C2 02 42 B 
C3 03 43 C 
C4 04 44 D 
C5 05 45 E 
C6 06 46 F 
C7 07 47 G 
C8 08 48 H 
C9 09 49 | 
СА 0A 4A J 
CB OB 4B K 
CC 0С 4C L 
CD 0D 4D M 
CE OE 4E N 
CF OF 4F O 
DO 10 50 P 
D1 11 51 Q 
D2 12 52 R 
D3 13 53 S 
D4 14 54 T 
D5 15 55 U 
D6 16 56 V 
D7 17 57 W 
D8 18 58 X 
D9 19 59 Y 
DA 1A 5A Z 
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Other codes that you might want to try are: 


Blank space EO -You can't see a blank space 


Solid block 20 -—— ——— Solid white block (like 
the cursor) 
-— — Solid white block blinks 


on and off 


Blinking block 60 


Have some fun experimenting with this program before moving on toa 
program that will let you print information on the screen as you type from the 
keyboard. | bet you always wanted to see your name in flashing lights. Now’s 
your chance! 

The last program of this chapter is one of the simplest that you have had 
so far, but it is one of the most powerful. It will allow you to fill the screen with 
text as you type it in from the keyboard. You may use spaces, punctuation, the 
return key, numbers, letters, etc. Three new instructions are used. 

After a key is read from the keyboard, the CMP (Compare) instruction is 
used to compare the value taken from the keyboard (whose ASCII code is in 
the accumulator after the key is pressed) with the value AF (the ASCII code for 
a slash, /). If the. keystroke has been a slash, the next instruction BEQ 
(branch if equal) will cause a branch to the end of the subroutine. Therefore, 
you type a slash when you are through using the keyboard. This would be 
similar to the BASIC statement: 


716 IF X72 175 THEN GOTO 784 


784 RETURN (AF HEX=175 decimal) 


or 
776 IF X$ = “/” THEN GOTO 784 
784 RETURN 


A JMP (Jump Absolute) instruction follows the print subroutine. JMP sends the 
computer back to look for another keystroke, and is similar to the BASIC 
statement: 


781 GOTO 771 


DISPLAY ANY MESSAGE PROGRAM 
1. REMARK ** CLEAR SCREEN ** 
768 20 JSR FCS8 
769 58 
770 FC 


718 


2. REMARK ** LOOP TO GET AND PRINT KEY ** 


20  JSRFD35 Get a key 

35 

FD 

C9 CMP AF Compare accumulator to AF 
AF 

FO BEQ06 Branch if equal 6 steps 

06 EXIT from loop 

20 JSR FDED Print the character 

ED 

FD 

4C ЈМР 0303 Go back for another keystroke 
03 (0303 HEX=771 decimal) 
03 


3. REMARK ** BACK TO BASIC ** 


784 60 RTS Return to Operating System 


In Section 2 of the program we used three new instructions. The CMP in- 
struction is similar to CPX and CPY. The Immediate mode is used to compare 
the value in the accumulator with the value that follows the instruction. The 
BEQ instruction that follows CMP causes a branch to take place if the two 
values are equal. If the branch is taken, it is to the RTS instruction 6 steps for- 
ward (from the program counters present position 778). If the branch is not 
taken, the JSR FDED instruction prints the character and steps the cursor for- 
ward one place. 

At the end of Section 2 is the third new instruction — JMP. This is an Ab- 
solute Jump. The program will always perform the jump if this instruction is 
executed. It works like the GOTO statement in BASIC. 

The program is only 17 bytes long, but it will let you type all day on the 
screen. When the screen is filled, it merely scrolls up to make room for more 
entries. When you want the program to stop, type the backslash mark. That will 
get you out of the loop to return to the BASIC Operating System. Of course, 
if you want to use the backslash while you are typing, you are out of luck. 
This program uses the backslash to end its operation. 

We can't show you how the screen looks, as you are in complete com- 
mand. It will display whatever you type. 
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SUMMARY 


You found additional useful built-in subroutines in this chapter for dis- 
playing characters and reading characters from the keyboard. Thus you are 
now able to use machine language programs to display both graphics and text. 
You learned the memory locations that are assigned to the video display, and 
you learned to use ASCII codes. 

You used all the instructions that were introduced in previous chapters as 
well as several new instructions. Here is a summary of the instructions intro- 
duced in this chapter: 


1. LDX (Load X register) — used in the Immediate mode as a counter in the 
same way that LDY was used with the Y register. 
Example: A2 ОР CODE 
00 data loaded into the X register 


2. INY (Increment register Y) — used to increase the value held in the Y regis- 
ter by one. Implied mode. 


Example: C8 ОР CODE 


3. INX (Increment register X) — used to increase the value held in the X regis- 
ter by one. Implied mode. 


Example: E8 OP CODE 


4. CPY (Compare Y register) — used to compare the value held in the Y regis- 
ter to the given number. It was used in the Immediate mode. 


Example: CO ОР CODE 
1A data to which the value held in the Y register is 
compared 


5. CPX (Compare X register) — used to compare the value held in the X 
register to the given number. It was used in the Immediate mode. 


Example: EQ ОР CODE 
06 data to which the value held in the X register is 
compared 


6. BNE (Branch if Not Equal) — used after a compare instruction to tell where 
the next instruction to be executed will be found if the result of the com- 
parison is not equal to zero. It is a Relative Mode instruction that includes 
data telling the computer where to move the program counter relative to 
its present position. 

Example: DO ОР CODE 
F5 data telling how 
far to move the 
program counter 
(-11 in this 
example) 
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10. 


11. 


. STA (Store Accumulator) — used this time in the Absolute Indexed mode. 


Stores whatever value the accumulator holds in memory assigned by the 
Absolute location given plus the value held in the Y register. 


Example: 99 OPCODE 
00 Least Significant Byte of Absolute location 
04 Most Significant Byte of Absolute location 


‚ LDA (Load Accumulator) — used in the Absolute Indexed Mode this time. 


Loads the accumulator with data from the Absolute memory location given 
plus the value held in the X register. | 


Example: BD ОР CODE 


14 Least Significant Byte of Absolute location 
03 Most Significant Byte of Absolute location 


. CMP (Compare Accumulator) — used in the Immediate mode to compare 


the value held in the accumulator with the given number. 


Example: CO OPCODE 
AF data to which the value held in the accumulator is 
compared 
BEQ (Branch if equal) — used in the Relative mode after a compare instruc- 
tion. Causes a branch if the values compared are equal. The data following 
the instruction tells how far and in what direction the branch will be taken. 


Example: FO ОР CODE 
06 data telling where to branch (6 locations forward in this 
example) 
JMP (Jump) — used in the Absolute mode to cause an unconditional jump 
to the specified memory location. 
Example: 4C ОР CODE 
03 Least Significant Byte of destination address 
03 Most Significant Byte of destination address 


TABLE OF SUBROUTINES USED SO FAR 


Location in 
Memory 


Function 


Clear the screen 
Set Graphics Mode 

Plot a point 

Draw a horizontal line 

Draw a vertical line 

Get a keystroke 

Print character in accumulator 

Print value in accumulator as two hex digits 
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TABLE OF MACHINE LANGUAGE INSTRUCTIONS USED SO FAR 


Mnemonic Bytes 
Code OP CODE Used Function 


Shift bits left 


Addressing 
Mode 


Accumulator 


Relative 
Relative 


Branch if equal 
Branch if not = 0 


Immediate 
Immediate 
Immediate 


Compare accumulator 
Compare X reg. to value 
Compare Y reg. to value 


Implied 
Implied 


Increment X register 
Increment Y register 


Absolute 
Absolute 


Jump 
Jump to subroutine 


Immediate Load Accumulator 


Absolute Load Accumulator 
Indexed 
Immediate Load X register 


Immediate Load Y register 


Implied Return from subroutine 


Store Accumulator 
Store Accumulator 
Store Accumulator 


Zero Page 
Absolute 
Absolute 
Indexed 


You covered a lot of ground in this chapter. You can now display both 
graphics and text on the screen. In the next chapter, we'll see if you can bring 
the Apple to life with some living sounds. 


EXERCISES 


1. The Absolute mode instruction STA 0400 would store the value contained in 
the accumulator into memory location 0400. Describe what the Absolute 
Indexed mode instruction STA 0400,Y would do. 
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. How many characters can the Apple computer display on each line? 
(decimal value) 


. If the value in the Y register is currently 26 (HEX) as the following portion of 
a machine language program is executed, tell which instruction will be exe- 
cuted following the BNE instruction. 


778 C8 INY 
779 CO  CPY 28 
780 28 

781 DO BNEFB 
782 FB 

783 60 RTS 


. If the value in Y is 27(HEX) and that portion of the program shown in Exer- 
cise 3 is executed again, which instruction would be executed following the 
BNE instruction? 


. If the ASCII code for the letter A is C1, what is the ASCII code for the 
letter G? 


. Given that the accumulator holds the ASCII code for the letter A. If the 
built-in subroutine at FDED is executed, an A is displayed on the screen. 
If the built-in subroutine at FDDA is executed while the same value is in the 
accumulator what will be displayed on the screen? 


. The ASCII code for the normal display of white on black for the letter C is 
C3 HEX (11000011 binary). The code for an inverted (black on white) 
letter C would be: 


а. НЕХ or  —— Ыіпагу. 
The code for a blinking C would be: 
Ы. —HEX or ———— —— Ыпагу. 


. Explain what the following instructions cause when executed. 
a. EO CPX 06 


06 

b. CO CPY1A 
1A 

c. C9 CMP AF 
AF 


123 


моилро м 


ANSWERS TO EXERCISES 


. Store the value contained in the accumulator into memory location 0400 + 


the content of the Y register. (If Y=5, the location where stored would be 
0400-5 or 0405.) 


40 


. 778 C8 INY (FB = -5 counting from 783) 
. 783 60 RTS (Ү= 27*1 = 28. Therefore BNE is not taken) 


C7 


. C1 (the ASCII code for A) 


a. 03 HEX or 00000011 binary 
b. 43 HEX or 01000011 binary 


a. The value in the X register is compared to 06. 
b. The value in the Y register is compared to 1A HEX. 
c. The value in the accumulator is compared to AF HEX. 
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Chapter 6 


Apple Sounds 


BOS 


You learned how to plot points and draw lines in Chap. 4. In this chapter, 
we'll explore an Apple feature that will appeal to another of your senses. 

Inside the Apple computer is a speaker that you can “tweak” or “strum” 
to your heart's content. A program can control the speaker so that it will make 
various sounds. The paper cone of the speaker can be in either of two positions, 


in or out. 


Cone in Cone out 
Exaggerated Side View of the Speaker Cone 


Each time a program references memory address C030 (HEX), the speaker 
changes from in to out or vice versa. This change causes the speaker to emit an 
audible click. By referencing address C030 frequently (which we call “tweaking” 
the speaker) a tone is produced. If you tweak it at different rates, different tones 
will be produced. You can also control the duration of the tweaking to produce 


tones of various lengths. 


T weaker 
Speaker 


With a little patience, you can produce a musical scale that you can use to play 
tunes. If you desire, you can draw graphics on the screen and accompany them 
with music of your own creation. 
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But, first let’s take a look at the sound capabilities of the Apple with a 
simple tone-producing program. An addition is made to the BASIC Operating 
System to allow you to choose the pitch for each sound you wish to play. After 
the pitch is selected, the machine language program is called to play the note. 
Then control is returned to the Operating System so that you can select a new 
pitch. This process is continued until you decide to quit. 


TONE EXPERIMENT PROGRAM 
1. REMARK ** INITIALIZE AND CLEAR SCREEN ** 


768 А9 LDAC8 Set the duration of the note 
769 C8 "OC 3 | | 


770 85 STA 0000 Store it in a special memory location 
7101 


77220 ЈЅВ FC58 Clear the screen 
773 58 
774 FC 


2. REMARK ** SPEAKER TWEAKER ** 


* 775 AD LDA C030 Load accumulator from memory 
776 30 C030; this reference to C030 tweaks 
771 CO the speaker 

* 778 88 DEY Decrement the Y register 
779 DO ВМЕ 04 Branch +4 (if not equal to zero) to 
780 04 785 

* 781 C6 DEC 0001 Decrement memory location 0001 
782 01 
783 FO ВЕО 08 Branch *8 (if equal to zero) to 793 
784 08 

* 785 CA DEX Decrement the X register 
786 DO BNE F6 Branch -10 (if not equal to zero) to 
787 F6 778 

* 788 A6 LDX 0000 Load X register from memory 0000 
789 00 
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790 4C ЈМР 0307 Jump back to 0307 hex (775 decimal) 
791 07 
792 03 


3. REMARK ** BACK TO BASIC ** 
793 60 RTS Return to Operating System - 


*New instructions or subroutines | 
MODIFICATION TO THE BASIC OPERATING SYSTEM 


The Tone Experiment Program requires that we add some lines to the 
BASIC Operating System (Chap. 2) to choose the pitch of the notes to be 
played. We will also include a statement that will let us decide when to terminate 
the program. The added lines аге: _ 


720 INPUT “PITCH (1-255 OR 0 TO QUIT)?”; P 


730 IF P=0 THEN 900 Input 1-255 for pitch or 
— zero (0) to quit 
740 POKE 0,P 


810 GOTO 720 


These new lines are inserted in the Operating System in the section that executes 
the machine language program as shown. Notice that the lines 720, 730, and 740 
are inserted before subroutine S is called in line 800 of the Operating System. 
Line 810 is executed after the return from the subroutine so that a new pitch 
may be selected. 


700 REM * EXECUTE THE MACHINE LANGUAGE PROGRAM * 
710 PRINT “PRESS ANY KEY TO RUN”: GET A$ 
added 720 INPUT “PITCH (1-255 OR ОТО QUIT)?”; P 
| 730 IF P=0 THEN 900 | 
740 POKE 0,P 


800 CALL S 
added | 810 СОТО 720 


900 END 
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Line 720 allows you to input the desired pitch. The value that you input 
should be in the range of 1 through 255 as indicated by the INPUT prompt in 
line 720. If you input a zero (0), line 730 will cause a branch to line 900, where 
the program will END. 


DESCRIPTION OF THE TONE EXPERIMENT PROGRAM 


Section 1 loads the value C8 HEX (200 decimal) into memory location 
0001 using the zero page store instruction. This value is used to control the 
duration of the notes. The video screen is also cleared in this section to avoid 
visual distractions. 

Section 2 is a loop that tweaks the speaker. It uses the X and Y registers 
to control the number of times the speaker is tweaked within the duration of the 
note. 

Several new instructions appear in this section. 


at 775: AD LDA C030 Loads the accumulator from memory 
30 location C030, causing the speaker to 
CO be tweaked. An Absolute Mode in- 

struction. 


“ 
ACCUMULATOR КО Twang 


at 778 88 DEY An Implied mode instruction that de- 
creases the value in the Y register by 1. 


Y = Y-1 in BASIC 


at 781 C6 DEC 0001 A zero page instruction that decreases 
01 the value in memory location 0001 by 
1. 
МЕМ = МЕМ-1 in BASIC 
at 785 CA DEX An Implied mode instruction that de- 


creases the value in the X register by 1. 


X = X-1 in BASIC 


at 788 A6 LDX 0000 A zero page instruction that loads the 
00 X register from memory location 0000 
(pitch). 


Memory 0000 ———» X register 
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Section 2 is composed of several values used as counting functions to de- 
termine how often and for how long the speaker is to be tweaked. If this section 
is not completely clear to you, don't worry about it — it works. 

Here is a flowchart showing the operation of Section 2. 


775 TWEAK SPEAKER 


Thief takes one 


778 DECREMENT Y 


E 


Another Thief 783 


LOAD X FROM 0000 


£g 
Уу Loader 
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Section 3 returns control to the BASIC Operating System to allow a new 
note to be selected. 

Thus we have created a loop from the operating system to the machine 
language program and back to the operating system. 


Flow Diagram 


[ee Le NE 

| Enter machine language | OPERATING 

| program | SYSTEM 

Е | 

| | —- | 

| Select the pitch | 

| | 

| Yes | 

| © | 

| 

| No | | 

| m Ж | | 

Loop | Call machine language | 

| program | 

бз р о у = 
виша i 
! Execute note t MACHINE 
i Return to Operating ! LANGUAGE 
| г PROGRAM 
| 


System 


By studying the flow diagram, you can get some idea as to the usefulness 
of a machine language program used as a subroutine to a BASIC program. Al- 
though BASIC may be easier for you to program, there are times when some 
part of a program may require great speed. The computer can execute a ma- 
chine language program much faster than it can BASIC (since BASIC must be 
interpreted). Therefore, a machine language subroutine can be used to execute 
that part of the program which must be done quickly. A return to BASIC is 
then used to perform the rest of the program, which does not require such 
quickness. i 


EXECUTING THE PROGRAM 


After you have modified the operating system by adding lines 720, 730, 
740, and 810 as suggested, enter the machine language program. It begins at 
memory location 768 and is 26 bytes long. When it has been entered and checked 
for errors, you will see the usual message: 
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IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?u 
After you type: 99 it will request the pitch. 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 

?99 

PITCH (1-255 ОКОТО QUIT)?» 


Type in a value that is in the requested range (1-255) and press the return 
key. The screen will go blank, the note will be played, and you will get a request 
for another pitch. 


Stay in the range 
or you will get an 
Error message 


PITCH (1-255 OR 0 TO QUIT)?s 


Try the complete range of tones from very low (255) to very high (1). 
Don't try 0 unless you want to stop experimenting. | 

You will probably want to see if you can construct a musical scale. If you 
have a piano or other musical instrument handy, this should be fairly easy. If 
your musical ear is not too good, don't let it bother you. Experiment anyway. 
We do not profess to be experts in the field of music, but we couldn’t resist 
trying to build a musical scale. 

Our piano is upstairs in the living room, and our Apple is downstairs in the 
den. Therefore, we used a tape recorder to copy the notes of one octave from 
the piano. We than took the tape recorder downstairs to the computer and 
played back the results to construct the scale. 


PIANO-TO-COMPUTER CONVERSION 


Piano ———~> С D E F G A В C 
Pitch value——» 133 127 121 116 111 107 103 100 
Middle C | 
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Try keying in these values in quick succession to see how it sounds to you. 
We will be using these values (and others) in future programs. If some notes 
don't sound quite right to you, make the necessary changes to the offending 
values. Then play the scale up and down. Get in lots of practice so that you will 
be ready for the music of the future. 


TOI) ag 
HOG) «/ 
MO eh 
MOM s 
пиа, 
пи и wi/ 
00313] %/ 


After practicing the scale, you can relax with the next program. It plays 
the scale for you. A loop is used to play all eight notes in an octave. Then con- 
trol is returned to the operating system. Several useful new instructions are 
introduced. 

Two of these new instructions are used to transfer data back and forth be- 
tween the X register and the accumulator. 

TXA is used to transfer the value in the X register to the accumulator. 
It is a single-byte instruction in the Implied mode. Its operation code is 8A. 


к УУ 
8A TXA [ 00 | [0] Value transferred 


Op code Mnemonic Accumulator but also remains 
code ua in X register 


TAX is used to transfer data in the opposite direction, from the accumu- 


lator to the X register. It, too, is a single-byte instruction. Its operation code is 
AA. 


a Әм 
AA TAX Value transferred 
Op code Mnemonic Accumulator X but also remains 
code register in the accumulator 
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The other two new instructions involve the use of a special section of 
memory called a stack. You might think of the stack as a pile of papers. You 
add to the pile by placing a paper on the top of the pile. You remove papers 
from the pile, one at a time, from the top. 


3rd paper 


2nd paper 


D NM st paper 


In the sketch above, the third paper must be removed before the second. The 
second must be removed before the first. For you business-oriented people, it's 
like a Last In — First Out (LIFO) file. | 

To push a value on the stack, the PHA (PusH Accumulator on stack) in- 
struction is used. Its operation code is 48. 

The Call instruction of the BASIC Operating System automatically Causes 
the correct address for the return from the machine language subroutine to be 
pushed on the stack. 


-—— 032A (810 HEX) is saved on top of the stack 


if the accumulator holds a value of zero and the PHA instruction is exe- 
cuted, the value of zero is pushed on top of the stack, and the other two values 
are pushed down one spot. 


LS 
48 PHA [o0]  «—— 00 pushed on 
accumulator -———— these two are pushed 
down one spot 
stack 


To pull a value off the stack, the PLA (PulL off stack to Accumulator) is 


used. Its operation code is 68. 
Suppose the stack holds the previous values. 


| 00 | 
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The PLA instruction is then executed: 


Accumulator 


7*— The value 00 is removed, and these values 
move up one spot ready to be used when the 
RTS machine language instruction is exe- 
cuted 


AUTOMATED SCALE PROGRAM 
1. REMARK ** CLEAR SCREEN AND INITIALIZE ** 
768 20 | JSR FC58 Clear screen 
769 58 
770 FC 


771 А9 LDAC8 Set duration 
772 C8. 


773 85 STA 0001 
774 01 


775 A2 LDX 00 Set counter to zero 
776 00 


Section 1 of the program clears the screen. 


( Screen cleared 


The duration of C8 (190 decimal) is loaded into the accumulator and 
stored from there into memory location 0001. It will be used in the note-playing 
loop in Section 3. 


0001 


The X register, which is used to index the LDA instruction in Section 2, is 
set to zero. 


x Loo | 


All instructions used in this section are familiar friends to you. 
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2. REMARK ** LOAD PITCH ** 
777 BD LDA 032Е,Х Indexed Absolute load, 


778 2E X register used to index 
779 03 
780 85 | STA 0000 Put in memory 0000 
781 00 
782 E8 INX Get ready for next note 
*783 8A TXA Transfer value in X register to 
accumulator 
*784 48 PHA Save on the stack 
785 ЕО CPX 08 See if all notes have been played 
786 08 
787 FO BEQ 17 Branch (if they have) to end 
788 17 


3. REMARK ** PLAY THE NOTE ** 


789 AD LDA СОЗО T weak speaker 

790 30 

791 CO Same loop as in the last program. This 
| loop is nested inside the loop that gets 

792 88 DEY a new note. 


793 DO BNE 04 
794 04 


795 Сб  DECOO001 © 
Get 796 01 
new 
note| Note 797 FO ВЕО 08 


loop|loop 798 08 
799 СА DEX 


800 DO BNE F6 
801 F6 


802 A6 LDX 0000 
803 00 


804 4C JMP 0315 
805 15 
806 03 


68 PLA Pull saved value off stack 
AA TAX Transfer to X register 

4C ЈМР 0309 Go back for new note 

09 


03 
]35 


HOW SECTIONS 2 AND 3 WORK 


Get the note 777-781 
from the memory 
and put into 0000 


IncrementX 782 
register 


Put new X value 783 Accumulator 
into accumulator | э» 
Stack 


Save it on the stack 784 


Compare X with 8 785-6 a IS X = 8? 
to see if all 

notes have been 

played 787-8 


This way if YES 
END 


If so, GOTO END. 


If not, play the 
note in Section 3 
Section 3 


789-806 ol play the note 


Then pull the 807 ^" 1 Bs p^ 
2 


value off the 
stack and put ACCUMULATOR 
in accumulator | | 


Transfer it back. 808 X Ll 


to the X register 


Go back for a new note 809-811 


When the last note has been played, a branch is made to Section 4. The old 
value of X is pulled off the stack so that the correct return address will be avail- 
able at the top of the stack. If we didn't remove the old X register value from 
the stack, the computer would think that number was part of the address to 
which it was to return. | 
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The RTS instruction at 813 returns the computer to the BASIC Operating 
System. 
Section 5 holds the data used for the notes. 


4. REMARK ** BACK TO BASIC ** 
812 68 PLA Pull value off en 
813 60 RTS | 

5. REMARK ** DATA LIST ** 


814 85 
815 7F -«—- Music scale in HEX 
816 79 
817 74 
818 6F 
819 6B 
820 67 
821 64 


Just as a DATA list in BASIC is not executed, so the data list in the ma- 
chine language program is not executed. It is there to provide the values accessed 
in Section 2 by the LDA instruction at location 777. 

Enter the program as usual by means of the Operating System. The pro- 
gram begins at memory location 768 and is 54 bytes long. Check for any errors. 
When all is ready, run the program. Although you will see nothing on the screen, 
an octave of notes is played from low note to high note. The computer then 
obediently returns to the Operating System. If you want to repeat the scale, 
type: 


GOTO 700 and press the RETURN key. 


The display will show: 


GOTO 700 
PRESS ANY KEY TO RUNS 


Line 700 of the Operating 
System executes the ma- 
chine language program 


When you press a key, the octave will be repeated. 

You could add more data to Section 5 so that the notes would go up and 
then back down the scale. You would also have to change the value at 786 in the 
program to give the total number of notes in the new data list. 

That wraps up this chapter. In the next chapter, we'll add graphics to our 
sounds and learn to play some notes directly from the keyboard. 
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SUMMARY 


One new built-in subroutine and seven new machine language instructions 
were added to your programming capabilities in this chapter. The use of sound 
has added a new dimension to your programming power. You can now use the 
speaker to go along with the keyboard and video display. | | 

You learned to move data back and forth between the accumulator and 
the X register. You also learned to use the stack to save information for later 


retrieval. a 
Here is a summary of the new subroutine and the new instructions intro- 


duced in this chapter. 


New Subroutine 


1. LDA C030 was used to toggle the speaker. When this is done rapidly, 
the speaker produces a tone. The pitch of the tone as well as its dura- 
tion can be controlled by the program. 

Example: AD OP code for Load Accumulator 
30 least significant byte of address 
CO most significant byte of address 


New Instructions 


1. DEC (DECrement memory) — used in the Zero Page mode to decre- 
ment (decrease by one) the value held in the specified memory location 
of zero page memory. 


Example: C6 OP code for DEC 
01 least significant byte of memory location 0001 
(the most significant byte is implied to be 00) 


2. DEX (DEcrement X register) — used in the Implied mode to decrease 
the value held in the X register by one. 


Example: · CA ОР code for DEX 


3. LDX (LoaD the X register) — used in the Zero Page mode to load the X 
register with the value held in the specified memory location of zero 
page memory 
Example: Аб ОР code for LDX 

OO least significant byte of memory location 0000 
(most significant byte is implied as 00) 

4. PHA (PusH Accumulator on stack) — used to push the value held in the 
accumulator on the top of the stack. This value is later retrieved for fur- 
ther use. Implied mode. 


Example: _ 48 ОР code for PHA 
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5. PLA (PulL from stack to Accumulator) — used to retrieve a value pre- 
viously pushed on the stack. The value is placed in the accumulator for 
use. Implied mode. 


Example: 68 ОР code for PLA 


6. TAX (Transfer data from Accumulator to X register) — used to transfer 
(or copy) data from the accumulator to the X register. Implied mode. 


Example: AA OP code for TAX 


7. TXA (Transfer data from the X register to the Accumulator) — used to 
transfer (or copy) data from the X register to the accumulator. Implied 
mode. 


Example: 8A ОР code for TXA 


TABLE OF SUBROUTINES USED SO FAR 


Function Location in Memory 


Toggle the speaker 

Clear the screen 

Set graphics mode 

Plot a point 

Draw a horizontal line 

Draw a vertical line 

Get a keystroke 

Print character in accumulator 
Print accumulator content as hex digits 


TABLE OF MACHINE LANGUAGE INSTRUCTIONS 


Mnemonic | Addressing | Op | Bytes 
Code Mode Code | Used Function 


Accumulator Shift bits left 

BEQ Relative FO 2 Branch if equal 

BNE Relative DO 2 Branch if not equal 

CMP Immediate C9 2 Compare accumulator 

CPX Immediate EO 2 Compare X register 

CPY Immediate CO 2 Compare Y register 
*DEC Zero Page C6 2 Decrement memory 
*DEX Implied CA 1 Decrement X register 

INX Implied E8 1 Increment X register 

INY Implied C8 1 Increment Y register 
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Mnemonic | Addressing 
Code Mode Function 


Absolute | Jump to memory 
Absolute Jump to subroutine 


Immediate Load accumulator 
Abs. Indexed Load accumulator 
Immediate Load X register 
Zero Page Load X register 
Immediate Load Y register 


Implied No operation 


Implied Push accumulator on stack 
Implied | Pull stack to accumulator 


Implied Return from subroutine 


Zero Page Store accumulator 
Absolute Store accumulator 
Abs. Indexed Store accumulator 


Implied Transfer Acc. to X register 
Implied Transfer X register to Acc. 


* Instructions introduced in this chapter 


EXERCISES 


1. Explain the result of executing each of the following machine language in- 
structions. 
a. СА DEX 


b. C6 DEC 0001 
01 


c. A6 LDX 0000 
00 


2. What happens if you input a O (zero) for the pitch in the Tone Experiment 
Program? | 


3. A low value for pitch in the Tone Experiment Program producesa.. 
(low, high) 
tone. A high value producesa.—— — . . tone. 

(low, high) 
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4. Describe the operation caused by these instructions: 
a. 8А TAX 


b. AA TXA 


The accumulator holds the value 


The instruction PHA is then executed. "Slow how he stack looks following 
that execution. 


5. The stack looks like this 


6. | If the stack looks like this ——————— 


[BD 


and the instruction PLA is executed, show the value in the accumulator and 
the contents of the top of the stack. — 


b PH 


Accumulator 
Stack 


ANSWERS TO EXERCISES 


1. a. Decrease the value in the X register by 1. 
b. Decrease the value in memory location 0001 by 1. 
c. Load the X register from memory location 0000. 


2. Execution of the machine language program is stopped. Control is returned 
to the Operating System. 

3. high, low 

4. a. TXA copies data from the X register into the accumulator. 
b. TAX copies data from the accumulator into the X register. 


5. |C1|<C1 on top 


Everything else pushed down one 


Stack 
6. | BD | 17 has been pulled off. 
Accumulator Everything else moves up one. 


Stack 
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Chapier 7 


More Sounds and Graphics 


You learned how to tweak the Apple’s speaker in Chap. 6 in order to pro- 
duce sounds. Sound is fine, but it is not very satisfying by itself. In this chapter, 
we'll combine some sounds with graphics to stimulate two of our senses at the 
same time. 


COMBINING THE SPEAKER AND VIDEO DISPLAY 


We'll build a new program using the graphics techniques learned in Chap. 4 
with the Automated Scale Program used in Chap. 6. The length of the program 
will increase, and some modification will be made to make the sound and 
graphics fit together in a smooth, coordinated manner. | 

Only one new instruction will be necessary. That instruction, LDY, loads 
the Y register from a memory location program indexed by the X register. Re- 
member, the point-plotting program uses the Y register to hold the column for 
plotting a point. These values are held in a data list starting at memory location 
0834. | 

Before looking at the program, study the flow diagram that follows. The 
diagram is laid out in blocks that correspond to individual sections of the pro- 
gram. | 

You have seen every instruction in Section 1 before. The duration of the 
notes is loaded in the accumulator (by the LDA instruction at 768). The screen 
is cleared (by the subroutine at FC58). The X register, which is used as a count- 
er, is set to zero (by the LDX instruction at 775). The low resolution Graphics 
mode is set (by the subroutine at FB40). The color to be used for plotting the 
notes is set to white (by the LDA instruction at 780 and the STA instruction at 
782). | | 
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Flow Diagram for Scale with Notes Program 


INITIALIZE VALUES 
for graphics and 
duration of notes 


Section 1 


Section 6 
Column and row from 
data lists 834-849 
Pitch from data list 
826-833 


Section 2 PLOT THE POINT 


Section 3 . | SET PITCH of note 
and save value in 


X register 


PLAY THE NOTE 


CHECK to see if 
all notes have been 
played 


Section 4 


Section 5 


BACK to BASIC 
Operating system 


SCALE WITH NOTES PROGRAM 
1. REMARK ** INITIALIZE ** 


768 A9 LDA C8 Set duration 


769 C8 

770 85 STA 0001 

771 01 

772 20 JSR FC58 Clear screen 

775 A2 | LDX 00 Set counter to zero 
776 00 

777 20 JSR FB40 Set Graphics mode 
778 40 

779 FB 

780 A9 LDA OF Set color to white 
781 OF 

782 85 STA 0030 Store it in memory 
783 30 
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Section 2 loads the column where the point is to be plotted into the Y 
register and the row where the point is to be plotted into the accumulator. A 
subroutine is then called to plot the point. The column and row values are stored 
in data tables at the end of the program. The X register is used as a pointer to 
access this data. 


2. REMARK ** PLOT THE POINT ** 


784 BC LDY 0342,X Load Y register from 0342 indexed by 


785 42 value in X register 

786 03 

787 BD LDA 034A,X Load accumulator for 034A indexed 
788 4A by value in X register 

789 03 

790 20  JSR F800 Call the point-plotting subroutine 
791 00 built-in 

792 F8 


In Section 3, the value for the pitch of the note is loaded into the accumu- 
lator from the data table and is then placed in memory location 0000, where it 
will be needed when the note is played. The value in the X register is placed in 
the accumulator and then pushed onto the stack for safekeeping. This has to be 
done, as the X register is used in Section 4 for another purpose. The value (saved 
on the stack) will be retrieved later when needed. _ 


3. REMARK ** GET READY FOR NOTE ** 


793 BD LDA 033A,X Load the pitch value from 033A in- 


794 3A dexed by the value in X register 

795 03 

796 85 STA 0000 Store in memory 0000 

797 00 | 

798 8A  TXA Put the value in the X register into 
accumulator 

799 48 PHA Push on the stack to save it 


Section 4 plays the note. It is the same as that used in Section 3 of the 
Automated Scale Program in Chap. 6. 


4. REMARK ** PLAY THE NOTE ** 
800 AD LDA СОЗО Tweak the speaker 
801 30 
802 CO 
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803 88 


804 DO 
805 04 


806 C6 
807 01 


808 FO 
809 08 


810 CA 


811 DO 
812 F6 


813 A6 
814 00 


815 4C 


816 20 
817 03 


818 68 
819 AA 
820 E8 


821 EO 
822 08 


823 DO 
824 D7 


825 60 


DEY 


BNE 04 


DEC 0001 


BEQ 08 


DEX 


BNE F6 (-10) 


LDX 0000 


JUMP 0320 


PLA 


TAX 


INX 


CPX 08 


BNE D7 


RTS 


Same as previous sound programs 


In Section 5, the computer checks to see if all of the notes of the scale 
have been played. If they have not, the program returns to Section 2 where a 
new note is plotted and played. If all notes have been played, control is returned 
to the BASIC Operating System. The old value of the X register is pulled off 
the stack and placed back in the X register. This value is then increased by one. 
Then the new value is compared to 8 (the number of notes desired). 


5. REMARK ** CHECK FOR ALL NOTES PLAYED ** 


Pull old X value from stack 

Transfer it into X register 

Increase count by one 

Compare notes played with 8 

If not, go back to get values for a new 
note to plot and play at 784 

If done, go back to monitor 
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The data tables for the column and row used for plotting the notes and the 
pitch values of the notes make up Section 6. 


6. REMARK ** DATA LIST ** 


826 88 -——— Pitch values 
827 79 
828 60 
829 67 
830 59 
831 51 
832 48 
833 44 


834 07 -——— Column values for plotting notes 
835 09 
836 OB 
837 OD 
838 OF 
839 11 
840 13 
841 15 


842 16 |» -——— Row values for plotting notes 
843 14 
844 12 
845 10 
846 OE 
847 OC 
848 OA 
849 08 


By combining graphics with the Automated Scale Program, you are able 
to display each note as it is played. 

Section 1 sets the note duration, clears the screen, and sets the X register 
to zero so that data may be accessed from various memory locations. The 
Graphics mode is then set, and the color is selected (you may change this if you 
like at location 781). 

Section 2 loads the Y register with the column and the accumulator with 
the row at which the note will be plotted. Both instructions use the X register 
as an index to select the correct values from a table located in memory beginning 
at the specified locations. The point-plotting roütine at F800 is then "called" to 
plot the point. 

Section 3 selects the pitch by the LDA and STA instructions at 793 and 
796. It also performs some TOUS KEepInE chores at 798-799 to save the index 
value on the stack. | 


146 


Section 4 is an old friend that plays the note. 
Section 5 restores the index value and compares it to 8 to see whether all 
the notes have been played. If they have not, the branch instruction at 823 
causes a return to 784 to plot and play a new note. If all eight notes have been 
played, a return is made to the BASIC Operating System. 
© Section 6 provides the data in three blocks. The first block (826-833) pro- 
vides pitch values for playing the 8 notes. The second block (834-841) provides 
values for the column in which each of the 8 notes is to be plotted. The third 
block (842-849) provides values for the row in which the notes are to be plotted. 


ENTERING AND RUNNING THE PROGRAM 


It's now time to enter the program. Once again, it begins at memory loca- 
tion 768. It is a long program, 82 bytes. | 

After you have entered it, be sure to check for errors. When it is error free, 
run the program. 5 

First one note appears, and middle С is heard from the speaker. 


The program then returns to the BASIC Operating System. If you want to see 
and hear the results again, type: GOTO 700 and press RETURN. The display 
shows: 
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]Goro 700 
PRESS ANY KEY TO RUN 


Press any key, and the process will repeat. 

By now, you are thinking of many variations that could be made. You 
could plot each note in a different color. You could put in a short melody in- 
stead of the scale. You could make each note disappear after it has been played. 
There are many variations you can try. We encourage you to try all of these and 
any others that you may think of. You now have the basis for a color organ that 
can play music as well as displaying colors on the screen. You don't have to stick 
to plotting a single point. You may want to fill the screen with color or project 
random color patterns as the notes are played. 

When you have experimented with the above program for some time, you 
may desire a change of pace. Wouldn't it be nice to be able to play notes that 
you select from the keyboard? Then you would be able to compose and play 
your own music. Read on, and we will show you a program that allows you to 

"tickle the ebonies" on the keyboard to play your own music. 


USING THE KEYBOARD TO PLAY THE NOTES 


You have used a program where you input the note that you wanted 
played. You also had a program where the computer played the musical scale 
for you. The next program combines the two techniques so that you can Key in 
continuous notes. It restricts you to one octave to keep things simple. The values 
for each note are stored in a data list, and by striking one of the numeric keys 
1, 2, 3, 4, 5, 6, 7, or 8, the computer will select the corresponding note. You do 
not even have to press the RETURN key. Remember, our crude scale is sup- 
posed to contain the octave starting with middle C. The keystrokes and corres- 
ponding notes are shown below. 


O2 


-Ө- 1 
Notes “— Keystrokes 
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768 
769 
770 


20 
58 
FC 


PLAY YOUR OWN TUNE PROGRAM 
1. REMARK ** CLEAR THE SCREEN ** 


JSR FC58 


Built-in routine to clear screen 


2. REMARK ** GET A KEYSTROKE ** 


771 
772 
773 


774 
7715 


*776 
777 


778 
779 


780 
781 


#782 
783 


20 
35 
FD 


C9 
BO 


30 
F9 


FO 
25 


C9 
B9 


10. 


F3 


JSR FD35 


CMP BO 


BMI F9 


BEQ 25 


CMP B9 


BPL F3 


Built-in routine to read keyboard 


Is key too low? 

If so, go back and look again 
(-7 steps) 

If itis a zero, go back to BASIC 


15 key too high? 


If so, go back and look again 
(-13 steps) 


3. REMARK ** CONVERT ASCII KEYSTROKE — USE TO INDEX ** 


*784 29 ANDOF 
785 OF 
786 АА TAX 


Strip off upper 4 bits of ASCII code 


Transfer result to X register to use as 
an index 


4. REMARK ** GET DURATION AND PITCH ** 


787 


A9 


788 60 


789 85 
790 01 


791 BD 


792 32 
793 03 


794 85 
795 00 


LDA 60 


STA 0001 


LDA 0332,X 


STA 0000 


Load duration 
Store it 


Load accumulator from data list 


Store it 
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5. REMARK ** PLAY THE NOTE ** 


796 AD LDA C030 Tweak speaker 


797 30 

798 CO 

799 88 DEY 

800 DO ВМЕ 04 
801 04 

802 C6 DEC 0001 
803 01 

804 FO ВЕО 08 
805 08 

806 CA DEX 
807 DO BNE F6 
808 F6 

809 A6 LDX 0000 
810 00 

811 4С JMP 031C 
812 1C 

813 03 


6. REMARK ** GET A NEW NOTE OR END ** 


814 4C ЈМР 0303 Get a new note 

815 03 

816 03 

817 60  RTS Back to BASIC Operating System 


7. REMARK ** DATA LIST ** 


*818 EA МОР 

819 85 -——— Lowest note in octave 
820 7F 

821 79 

822 74 

823 6F 

824 6B 

825 67 

826 64 -—- Highest note in octave 


*New instruction 
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"n 


GA BC. 
“з 
keystroke note note value 


DESCRIPTION OF THE PROGRAM 


Section 1 clears the screen. Section 2 uses the Apple machine language 
monitor's built-in subroutine to look for a keystroke. When found, the ASCII 
code for the character of that key is placed in the accumulator. The ASCII codes 
for the ten symbols used are: 


Digits ASCII Codes (in HEX) 


0 BO 
1 B1 
2 B2 
3 B3 
4 B4 
5 B5 
6 B6 
7 B7 
8 B8 
9 B9 


After a keystroke has been made, the value in the accumulator is compared to 
BO and B9 (the correct range for the digits). If the ASCII code is below BO or 
above B9, the keystroke will not be accepted. The program will not play a note, 
but will return to read another keystroke. This is accomplished by the BMI 
(Branch if Minus) and the BPL (Branch if PLus) instructions. These two new 
instructions are similar to the BNE (Branch if Not Equal) and BEQ (Branch if 
EQual) instructions that you have used before. 


BMI (BRANCH ON RESULT MINUS) 


Addressing Mode OP Code 


15] 


As used in the Program: 


774 C9 Compare ASCII code for keystroke to BO 

775 BO 

776 30 Branch on result minus back 7 steps (F9=-7) . 
777 F9 | | 


If the ASCII code of the keystroke is less than BO, the Branch on Minus 
instruction sends the program execution back to 771 to read the keyboard again. 
Thus, any keystroke whose ASCII code is less than BO wi// not be accepted. 


BPL (BRANCH ON RESULT PLUS) 


Addressing Mode OP Code 


As used in the program: 


780 C9 Compare ASCII code for keystroke to B9 
781 B9 

782 10 Branch on result plus back 13 steps (F3=-13) 
783 F3 


If the ASCII code of the keystroke is greater than B8 (zero is considered 
positive by this instruction), the Branch on Plus instruction sends the program 
execution back to 771 to read the keystroke again. Thus, any keystroke whose 
ASCII code is greater than B8 will not be accepted. 

If the zero key is struck, a branch is taken to the RTS instruction which 
returns you to the Operating System. It is used to stop the program after you 
have decided to discontinue playing notes. 

Section 3 converts the ASCII value to a decimal digit so that it can be used 
in the X register as an index to access the correct note from the data list. By 
looking at the above ASCII code table for the decimal digits, you can see a 
similarity between the digit and its ASCII code. A new instruction, AND, is 
used to "strip" the upper four bits from the ASCII code. In other words, the 
B is removed from the values BO through B9, leaving only the decimal digit on 
the right side of the two-digit HEX value. 


AND (AND WITH ACCUMULATOR) 


Addressing Mode OP Code | 
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As used in this program: 


ASCII code for the keystroke is in the accumulator. 


184 29 AND the value in the accumulator 
785 OF with the HEX value OF 


To show an example, we will look at the ASCII code in its binary form. 
The AND instruction operates on the ASCII code in the accumulator and the 
value immediately following the AND instruction. It compares corresponding 
bits of the two values. If a particular bit is a one (1) for both values, the corres- 
ponding bit of the result will be a one. If the bit of either value (or both) is a 
zero, the corresponding bit of the result will be a zero. 


Examples: 
AND accumulator with the value OF 


The keystroke is a 5. 
ASCIllcodeisB5- 10110101 inbinary 
AND with value OF = 000.01 1 1 1 in binary 


і 


t 
Result left in 000001 0 1 Onesonly in the bits that 
accumulator №7 havea in BS AND OF 


Result = 05 (the keystroke) 


AND accumulator with the value OF 


The keystroke is a 9. 
ASCII code is B9=1 0 1 1 1 0 0 1 inbinary 
AND withOF =00001 1 1 1 in binary 


p 
Result left in 0000100 1 Ones only if B9 AND OF both 
accumulator contain ones 


Reslut = 09 (the keystroke) 


Because of the way the AND is used in this program (AND OF), the result 
will always throw away the left four bits (Most Significant Bits) of the value in 
the accumulator and keep the right four bits (Least Significant Bits) the same. 
The program then places this result in the X register (instruction TAX at 786) 
so that it can be used to index the LDA command in Section 4 to load the cor- 
rect pitch for a given keystroke from memory. 
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The sequence resulting from a keystroke is shown below: 


If you 


type this, this note will be played. === б“ 


Memory 
accessed 
Key ASCII After by LDA 
Stroke Code AND 0332,X 


Memory Address | Memory Content 
HEX Decimal (Note Value) 


B5 05 033245 > 
B6 06 033246 > 
B7 07 0332+7> 
B8 08 0332+8 > 


This value put ковак) 


for this index 


COMA NH - Wh — 


Once again, we see that the action takes place in the accumulator (caused by the 
AND instruction), and the result is then transferred to the location (X register 
in this case) where it will be used. 

Section 4 loads the note duration (60 HEX) into memory location 0001. 
Then the pitch value is loaded from memory location 0332 + the value in the X 
register. This is stored in memory location 0000. Because of the AND instruc- 
tion used in Section 3, the note will be loaded from 0332 + whatever key was 
struck (1, 2, 3, 4, 5, 6, 7, or 8). 

Section 5 should be very familiar to you by now. It plays the note using 
the values for pitch and duration that were stored in Section 4. 

Section 6 provides a jump instruction to return for another note. It also 
has an RTS instruction following the jump. The RTS instruction will only be 
reached from the branch in Section 2 (778 BEQ) resulting from the keystroke 
of zero (0). RTS, of course, returns you to the Operating System as in previous 
programs. 

Section 7 is the data list from which the note selections are made. A new 
instruction (NOP) that does nothing is used at the beginning of the data list. This 
instruction (No OPeration) is used as a buffer to separate the program from the 
data list. The instruction that loads from the data list (BD at location 791) 
points to the value EA (No OPeration), but it is indexed by the X register which 
is always equal to or greater than one. Therefore, the NOP instruction (EA) is 
never executed. NOP instructions are quite often used to “save a place” for in- 
structions that may be added later to modify a program. If we wanted to insert a 
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note lower than middle C, we could use the memory occupied by the NOP in- 
struction. The program could then be modified to use the keystroke zero to 
access this new note. 

The data list pointer works like this: 


From 791 BD LDA 0332,X (0332= 818 decimal) 
Section 4 (792 32 

793 03 X holds the value keyed in (1 through 

8) and determines what value will be 

accessed here 

Data pointer starts here — 

If X271, 033211 points here ——Ó 

lf X22, 033242 points here — 

If X73, 033273 points here —— M 

From If X24, 033214 points here ——> 822 74 

Section 7 | If X25, 0332-5 points here ————> 823 6F 

If X=6, 0332+6 points here ————> 824 6B 

If X=7, 0332+7 points here ———> 825 67 

If X28, 033248 points here — 826 64 


ENTERING AND RUNNING THE PROGRAM 


Enter the program that begins at memory location 768 decimal. It is 59 
bytes long. Check your entries for errors, correct any errors, and run the pro- 
gram. | 
The screen will go blank. Then the blinking cursor will appear in the upper 
left corner. 


It’s time now for you to enter notes. Pressing any of the number keys 1 through 
8 will cause a note to be played. After each note, the blinking cursor flashes in 
the upper left corner. The computer is waiting for your next entry. Play around 
with the scale until you have a good feel for the computer “organ.” Then call in 
your friends and show off your musical talent. 

There are many modifications that you can make to this program. By in- 
creasing the size of the data list, you can increase the number of notes available 
to you. You might want to add some color graphics to this program in order to 
have a color organ. 


Color and Sound 
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SUMMARY 


Two long programs were used in this chapter to demonstrate the use of 
color and sound. You learned to coordinate the use of the speaker, the video dis- 
play, and the keyboard. Five additional instructions were introduced. The list of 
instructions that you have used has grown large enough to construct more com- 
plex and useful programs. 

You learned more about the capabilities of the Y register through two new 
instructions. Two new branch instructions were introduced, and you used the 
logic instruction (AND) to convert an ASCII code into its equivalent decimal 
digit. 

Here is a summary of the new instructions introduced in this chapter. 


1. AND (AND with accumulator) — used in the Immediate mode to logically 
AND the value following the instruction with the value in the accumulator. 
The result contains 1’s in the bits where both values have ones. Otherwise, 
zeros. | 


Example: 29 ОР code for AND 
OF HEX value to be ANDed 


2. BMI (Branch on Minus) — used in the Immediate mode to branch when a 
given condition is negative. The data following the instruction tells which 
direction and how far to branch from the existing position of the program 
counter. | 


Example: 30 ОР code for BMI 
F9 data says to go back 7 steps (F9 = -7) 


3. BPL (Branch on PLus) — used in the Immediate mode to branch when a given 
condition is positive or zero. The data following the instruction tells which 
direction and how far to branch from the existing position of the program 
counter. 


Example: 10 ОР code for BPL 
F3 data says go back 13 steps (F3 = -13) 


4. DEY (DEcrement Y register) — used in the Implied mode to decrease the 
value held in the Y register by one. 


Example: 88 ОР code for DEY 


5. LDY (LoaD Y register) — used in the Absolute Indexed mode to load the Y 
register from a memory location indexed by the value in the X register. 


Example: BC ОР code for LDY (Absolute Indexed) 
42 least significant byte of memory location 
03 most significant byte of memory location 


The value in the X register is added on to this “base” address to get the 
true address | 
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TABLE OF MACHINE LANGUAGE INSTRUCTIONS USED 


Op | Bytes. 
Code | Used Function 


Addressing 
Mode 


Mnemonic 
Code 


AND bits with accumulator 
Shift bits left 


Immediate 
Accumulator 


Branch if equal 
Branch if minus 
Branch if not equal 
Branch if plus 


Relative 
Relative 
Relative 
Relative 


Compare accumulator 
Compare X register 
Compare Y register 


Immediate 
Immediate 
Immediate 


Decrement memory 
Decrement X register 
Decrement Y register 


Zero Page 
Implied 
Implied 


Increment X register 
Increment Y register 


Implied 
Implied 


Absolute 
Absolute 


Jump to memory 
Jump to subroutine 


Load accumulator 
Load accumulator 
Load X register 
Load X register 
Load Y register 
Load Y register 


Immediate 
Abs. Indexed 
Immediate 
Zero Page 
Immediate 
Abs. Indexed 


No operation 


implied 


Push accumulator on stack 
Pull from stack to accumulator 


Implied 
Implied 


Implied Return from subroutine 


Store accumulator 
Store accumulator 
Store accumulator 


Zero Page 
Absolute 
Abs. Indexed 


Transfer accumulator to X register 
Transfer X register to accumulator 


Implied 
Implied 


*Instructions introduced in this chapter 
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TABLE OF SUBROUTINES USED SO FAR 


Function Location in Memory 


Toggle the speaker 

Clear the screen 

Set graphics mode 

Plot a point 

Draw a horizontal line 

Draw a vertical line 

Get a keystroke 

Print character in accumulator 

Print accumulator content as hex digits 


EXERCISES 


— 


. Explain the result of executing the following machine language instructions. 
a. BC LDY 0342,X 
42 
03 


b. 88 DEY 


2. A Compare X with 08 (CPX 08) instruction is used at 821 and 822 of the 
Scale with Notes Program. Which of the following operations does it per- 
form? | 
a. 08 — value in X register 
b. value in X register — 08 


чә 


. А subroutine at memory address FD35 is used to read the keyboard in the 
Play Your Own Tune Program. When you press a key in this program to play 
a note, is it necessary to press the RETURN key following the keystroke? 


4. If the following HEX values are ANDed with OF, what are the results? 
a. B7]...  . . b. BA... c. Е5 


5. What would be the result of 3F (HEX) ANDed with 63 (HEX)? 


6. In the Play Your Own Tune Program, which of the following ASCII values 
will cause a note to be played? 
a. A9 b. B3 c. BA d. BO 
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EN 


С 


ANSWERS TO EXERCISES 


. а. The Y register is loaded from the memory location whose address is 
0342 * the value in the X register. 
b. The value in the Y register is decreased (decremented) by one. 
. b. Value in X register — 08 
No 
. à. 07 (or 7) 
b. 04 (or 4) 
c. 05 (or 5) | 
23 3F-0011 1111 
63 = 0110 0011 


AND = 0010 0011 
— —— 
2 3 
. b. (B3 only) (A9 is too low—not accepted, BA is too high—not accepted, 
BO will return the machine language program to the BASIC Operating 
System) 
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Chapter 8 


The Apple System Monitor 


In the previous chapters you have been using BASIC to write and execute 
machine language programs. This convention has allowed you to make use of 
your knowledge of BASIC as you became acquainted with the language of the 
computer. It's time now to discard the BASIC Operating System as a tool. 
You've outgrown your need for it. 

The Apple computer has a System Monitor way up high in its memory (see 
memory maps in Chap. 2). 


Way up high 


The monitor controls a// programs, and all programs use it. Maybe you didn't 
realize it, but you have been using it all through this book. From here on, you'll 
communicate with it directly. 

You can use the monitor to look directly into memory locations, change 
the contents of memory, and even write machine language programs to be exe- 
cuted directly by the 6502 microprocessor. 

Remember, the computer understands only binary-coded instructions. The 
System Monitor will accept these instructions in hexadecimal form from the 
keyboard. You may want to return to Chap. 3 for a brief review of instruction 
code format. 

Let's go back to one of your first machine language programs described in 
Chap. 3. It loaded the accumulator with the HEX value 13 and stored the value 
in memory location 0325 (HEX). The program was stored in memory as: 
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Address Op 


Decimal HEX Code Remarks 
768 0300 A9 LDA with 
769 0301 13 data 
770 0302 8D STA in memory 
771 0303 25 | 
772 0304 03 0325 
773 0305 60 RTS 


That program was called from our BASIC Operating System, so the last in- 
struction was RTS (ReTurn from Subroutine). The Apple System Monitor treats 
machine language programs as subroutines. Therefore, RTS can also be used as 
the last instruction in its machine language programs. The program above can be 
entered directly using the System Monitor. 

We'll now show you how to use the monitor so that you can see how easy 
it is to load, examine, and execute a machine language program directly. 

Look at your User's Manual to see how to enter the System Monitor for 
your Apple version. For ours, all we have to do is press the RESET key. Another 
way would be to turn the computer off and then back on. When first turned on, 
our version always comes up in the monitor. If you have an Apple 11 Plus System 
with Autostart ROM, you enter the System Monitor by executing the BASIC 
statement: 


CALL 65385 
Or 


CALL -151 


When you are in the System Monitor, the screen will show the asterisk as a 
prompt signal. | 


D 


Asterisk prompt Cursor 


To enter the program, first type the starting address in HEX: 300 


| *300m 


Follow this with a colon, which tells the monitor that you want to alter 
the contents of memory. Follow the colon by each two-digit HEX code for 
the instructions or data (only one digit is needed if the lead digit is a zero). Sep- 
arate each code by a blank space. The program can be typed on one complete 
line as follows: | 
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МОМ!!! 


СКЕАТ! 
| ЕАЅҮ! 


Just the starting colon Each instruction in order separated by one blank 
address is needed space: 


*300:A9 13 8D 25 3 60m 
аам ш 


Just as in a BASIC program, the RETURN key is pressed at the end of 
each complete entry. When the RETURN key is pressed at the end of the above 
line, you see: 


*300:A9 13 8D 25 3 60 


Ready for more, but that's all we have 


That's all there is to it. If you are not confident that the program has been en- 
tered correctly, you can examine memory to verify what you just entered. To 
show what is in a given block of successive memory locations, type in the start- 
ing address of the block and the ап address of the block separated by a 
period. 


*300:A9 13 8D 25360 4——- You entered 


*300.305m ——— ——- Туре this and press RETURN 


crm Ending address 


period 


Then you see: 


*300:A9 13 8D 25360 ~—— You entered 
*300.305 A You want examined 


0300- A9 13 8D 25 03 60 -«— Computer shows you 
*. 


Ready for more — 
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Yes, the program is there. Now, how easy is it to make the program run? 
Very easy! Just type: 300G 


*300:A9 13 8D 25 3 60 ~—— Ready 
*300.305 


0300- A9 13 8D 25 03 60 4— Set 
*300Gm | 


BY typing the RNS ee GO! 
followed by the letter G (for GO), 
the program is executed. 


*300:А9 13 8D 25 3 60. 


*300.305 


0300- A9 13 8D 25 03 60 
*300G 


*- Well, what happened? Oh, we didn't ask the computer 
Tee display anything, so it just did its job and stored the 


value 13 in memory location 0325. How can we check 
it? | 


To find out if the 13 was really moved to memory location 0325, we must 
examine that memory location. To look at just one memory location, merely 
type the address of the location and press the RETU RN key. 


*300:A9 13 8D 25 3 60 
*300.305 


0300- A9 13 8D 25 03 60 
*300G 


*325 e To see memory location 0325 


0325- 13 


e Ц 


Yes, there it is. 
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Well, you know how to store some data in memory. That's not very useful 
by itself, but most problems to be solved by the computer involve moving data 
back and forth between memory and the accumulator. Let's see how it works in 
some programs that serve some useful purpose. 

We've made it all the way to Chap. 8 without doing a bit of arithmetic. 
Who ever heard of a computer that couldn't add and subtract? 

The 6502 microprocessor includes instructions that are capable of addi- 
tion and subtraction. Multiplication and division instructions are not available, 
but routines can be created by the programmer to perform those operations. 
These routines will be discussed in Chap. 12. 

Addition and subtraction are performed by two instructions that have 
several different addressing modes (Immediate, Zero Page, Absolute, etc.). We 
will be using the Immediate Addressing mode first. 

The mnemonic codes for the add and subtract instructions are: 


ADC (ADd to accumulator with Carry) 
and 

SBC (SuBtract from accumulator with borrow) 
Borrow is the inverse of Carry 


Remember that the 6502 is an 8-bit microprocessor and can only handle 
8 bits (one byte) of data at one time. The addition and subtraction operations 
are performed in a binary fashion, on one bit at a time. 


Example: 
00111100 ——— In accumulator (3C HEX) 
+ 00100011 -«———— То be added (23 HEX) 


TN 1 1st (0+1=1) 
Lt) 1 2nd (0+1=1) 
1 3rd (1+0=1) 
1 4th (1+0=1) 
1 5th (1+0=1) | 
0 6th (1+1=10, put down 0 and carry 1) 
1 7th (0+0=0+саггу=1) 

0 8th (0+0=0) 


01011111 +—— Result (5F HEX) 


Let's try our example in a short machine language program. These are the 
instructions that we will need. 
1. 18 CLC (CLear Carry flag — or carry bit, Implied mode) 
O 


code mnemonic code 

This is a new instruction that is necessary to make sure that a zero is placed in 
the carry bit of the status register. lf the carry bit happened to be set to one, 
we would get an incorrect ш (one too large). 
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2. AQ LDA (LoaD the Accumulator, Immediate mode) 
ob 
code mnemonic code 
You have used this instruction before. It puts the first value to be added (3C 
HEX = 00111100 binary) іп the accumulator. 


3. 69 ADC (ADd to accumulator with Carry, Immediate mode) 
Ob CODE mnemonic code 
Another new instruction. It adds the value immediately following the instruc- 
tion (23 HEX = 00100011 binary), the value in the accumulator (3C HEX = 
00111100 binary), and the value in the carry bit of the status register (0 or 
1). 

We'll also use the monitor subroutine that displays the contents of the 
accumulator at the end of the program so that we can see the result of the addi- 
tion. 

This is the program. 


300 18 CLC Clear carry flag 

301 A9 LDA 3C Load 3C in the accumulator 

302 3C 

303 69 ADC 23 X. Add 23 

304 23 

305 20 JSR FDDA Display a hexadecimal byte from the 
306 DA | accumulator 

307 FD 

308 60 RTS Return to monitor 


Now we're ready to go. 
1. Enter the program. 


*300:18 A9 3C 69 23 20 DA FD 60 


*. 


2. Run the program starting at 300. | 


*300:18 A9 3C 69 23 20 DA FD 60 
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Try adding some other pairs of HEX numbers with the addition program. 
The HEX values should be substituted in the original program at memory loca- 
tions 302 and 304. 

To change a given memory location, type in the address followed by a 
colon and the new value. 


*300G 
5F 
*302:28 ~<——— First change 


*304:1E -———— Second change 
*. 


Here are some examples you might try. 
Examples and results you should obtain: 


MS i ese 


1. 40 decimal. EX+00101000 binary 
30 decimal 28 piu 1110 00011110 binary 


01000110 binary = 


46 HEX -«———— This will be displayed 
Enter these | 


2. 120 decimal HEX»-01111000 binary — 
105 decimal |69| HEX-- 01101001 binary 


11100001 binary = 


[ ET] HEX ~——Displayed 
Enter these 
3. 165 decimal HEX-2- 10100101 binary 
47 decimal HEX+>00101111 binary 


11010100 binary = 
HEX ~———— Displayed 


One caution must be observed when using this addition program. The sum 
of the two values to be added must be less than 256 decimal or it will not fit 
in the accumulator. Remember, you are using an 8-bit computer. 

The accumulator and all memory locations can hold only 8 bits of data. 
The largest 8-bit binary number is 11111111, which is FF HEX or 255 decimal. 
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Example: 


In accumulator —» 11100000 = EO HEX 
Add -— + 10000001 = 81 HEX 


1 01100001 = 161 HEX 
Extra bit Only these 8 bits fit ko True result 
will not fit in the accumulator (61 HEX) 


In order to take care of results larger than FF HEX when adding two 8-bit 
numbers, the 6502 has a way to keep track of that extra bit that won't fit in the 
accumulator. It uses a special register. 


THE PROCESSOR STATUS REGISTER 


The 6502 microprocessor has a special register called the processor status 
register (status register for short), which keeps track of such things as overflow, 
carry, negative result, zero result, etc. Each bit in this 8-bit register is assigned a 
special condition as shown. 


bit number 76 54 3 2 [ 


Carry 

Zero result 
Interrupt disable 
Decimal mode 
. Break command 
Expansion 
Overflow 
Negative result 


It is this status register that determines whether branches are made or not 
made when using the instructions: 


BMI (Branch on minus) — the N bit = 1 

BPL (Branch on plus) — the N bit = O 

BEQ (Branch if equal zero) — the Z bit = 1 

BNE (Branch if not equal to zero) — the Z bit = O 


Notice bit zero (labeled C) of the status register. If a carry occurs when an in- 
struction is executed, this bit in the status cud is set to a one (1). In our pre- 
vious example: 
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11100000 In accumulator 
10000001 Added 


1 01100001 
S — 


Will appear will be in the accumulator 
in the carry | 

bit of the status 

register 


Even though the extra bit does not appear in the accumulator, it has not 
been lost. It is in the carry bit of the status register. You, the programmer, must 
make some provision to test the carry bit to see if a carry has occurred. The 
6502 instruction set provides for a way.to do this. In fact, there are two instruc- 
tions that may be used. | 


BO  BCS (Branch on Carry Set) 


p code 


When this instruction is executed, a branch is taken the specified num- 
ber of steps forward or backward /f the carry bit has been set. 


90  BCC (Branch on Carry Clear) 


Op code 


When this instruction is executed, a branch is taken the specified num- 
ber of steps forward or backward /f the carry bit has not been set (or 
has been cleared). 


Our first addition program worked like this: 


SYSTEM MONITOR 


Clear carry 
Load accumulator 

with 1st number 
Add 2nd number 


Display result 


To take care of the carry created by a sum greater than FF, we must modify the 
program's flow. 
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The modified addition program will work like this: 


SYSTEM MONITOR 


Clear carry bit 

Load accumulator 
with first number 

Add second number 


was 
a Carry 


made 
? 


Store accumulator 
in memory 330 

Load accumulator 
with a 1 

Display it 

Load accumulator 

from memory 330 


Display accumulator 


Two possibilities exist when the addition has been made. The action taken 
depends upon whether or not the carry bit has been set. 


1. NOCARRY 32 
+28 


5A 


C [o] Accumulator 


ANSWER IMMEDIATELY DISPLAYED 


5A 
2. CARRY 32 
+E3 
115 
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C Accumulator 


stored 


00010101} Memory 330 


P di 00000001| Accumulator loaded 
displayed 


00010101| Load Accumulator 


from memory 330 
115 


M, NM 


We will use the Branch on Carry Clear instruction to modify our addition 
program to take care of sums greater than FF. 


MODIFIED ADDITION PROGRAM 
1. Clear the Carry bit 


300 18 CLC Clear Carry 
2. Load and Add Two Numbers; then Branch if No Carry 
301 A9 LDAEO Load 1st number 
302 EO 
303 69 Арс 81 Add 2nd number 
304 81 
305 90 BCC OB Branch if no carry 11 steps forward 
306 OB 
3. If Carry, Store accumulator; Load and Display Carry 
307 8D STA 0330 Save low order part of result 
308 30 
309 03 
30A А9 LDAOI Load carry 
30B 01 | 
30C 20 JSRFDDA Display it 
30D DA 
30E FD 
30F AD LDA 0330 Reload low-order part of result 
310 30 
311 03 


4. Display Accumulator and Return to Monitor 


312 20 JSR FDDA Display accumulator 
313 DA | 

314 FD 

315 60 RTS Go back to Monitor 
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If the sum of the two numbers is FF or less, no carry will result. There- 
fore, the accumulator contains the true result. The branch will be taken at 305, 
and the value in the accumulator will be displayed by the JSR instruction at 312 
(Lines 307-311 are skipped). 

If the sum is greater than FF, the carry bit will be set. The accumulator 
will not hold the true result. It will only contain the lower 8 bits of the true 
result. Since the display subroutine prints the contents of the accumulator, we 
must first save the lower 8 bits so that the display will first show the bit that was 
carried. After storing the lower part in memory, the accumulator is loaded with 
a one. After the one is displayed, the accumulator is reloaded with the lower 8 
bits, and it is displayed. The result will appear as one complete number: 


016 1 
In our example, we know the result will be greater than FF (from our 
paper-and-pencil result). 


From carry From accumulator 


EO = 1110 0000 
81 = 1000 0001 


10110 0001 
< =» 


x 
Set the carry bit In accumulator 
The true result is: 16 1 
~— aa 
From carry From accumulator 


Loaded into accumulator Held in memory 0330 


Now, since you know the result, enter the program. 


*300:18 A9 EO 69 81 90 0B 8D 30 03 A9 01 
20 DA FD AD 30 03 20 DA FD 60 


*. Press RETURN after all codes are entered 


Now run the program. 


*300:18 A9 EO 69 81 90 OB 8D 30 03 A9 01 
20 DA FD AD 30 03 20 DA FD 60 


*300G 
0161 -——— ihe correct answer is displayed. First 1 from 
*- the JSR at 30C, then 61 from the JSR at 


312. 
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One new instruction was used in the program. 


at 30F: LDA 0330 This is the load accumulator from memory 
using the Absolute Addressing mode. The 
data is loaded from the specified memory 
location. 


SUBTRACTION 


Let's take a look at subtraction now. First consider a binary subtraction as 
it would be performed with pencil and paper. Remember that binary arithmetic 
is done in base two. So when a borrow occurs, you borrow a power of two in- 
stead of a power of ten, as you would if you used the decimal system. 

If a bit is a О, the borrow makes it 10. 


Examples: 
Suppose we have the binary number 110. Look at the place values of 
each bit. | 
2° 2! :99 
1 1 0 
"This bit is 0 
If a borrow is made to enlarge the 2° bit, 
24. Qt 2° 
1 1. 0 
V Borrow is made from the 2! bit 


Think of the result of the borrow to be: 
ey 29 
1 O 10 


Borrow was We borrowed one 2!, which is equal to two (10 
made from binary) 29 
here 


Subtraction example: 


6 decimal - 3 decimal in binary is: 


1.1 0 
-0 1 1 1. Borrow a 2? 
1 0 10 
-0 1 1 
1 Two - one is one, but now we must borrow again 
for the next place 
0 10 10 
-0 1 1 
0 1 1 Result of 6-3 = 3 
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It's really just like subtraction in the decimal system, except that you 
borrow powers of two instead of powers of ten. Here are some examples of sub- 
traction of 8-bit binary numbers. 


No borrow 


10101101 = AD HEX = 173 decimal 
- 00100101 = 25 HEX = 37 decimal 


10001000 = 88 HEX = 136 decimal 


With borrow 


) 


00111100 Can’t subtract 1 from 0 so — borrow one 4 = (10) 
~ 00100011 two’s in binary 


) 


001110 10 0 Now borrow one 2 = 10 one’s 
1 1 


- 001000 This leaves one 2 = 1 two 
001110 ^ 

-001000 1 1 
000110 0 1 


3C - 23 2 19 HEX 


After all this, | must admit that the computer doesn't do subtraction that 
way. It doesn't have paper and pencil. In fact, it doesn't really know how to sub- 
tract at all. It uses a method called two's complement addition. |t may sound 
odd to use the addition process to perform a subtraction operation. However, by 
doing so, the arithmetic unit of the 6502 microprocessor need only contain an 
adder to perform all of its arithmetic. Therefore, it doesn't have to be so com- 
plex as it would have to be if it had an adder and a subtracter. 

To understand what is meant by two's complement, look at the following 
examples of a binary one's complement. 

1. A binary number — —— 10011100 

Its one's complement —> 01100011 «<———— All 1's become O's. 
All O's become 1's. 


2. A binary number ———> 01010101 
Its one's complement —* 10101010 


The one's complement is obtained by changing each bit of the number (a one or 
a zero) to its opposite (or complement). All 1’s are changed to 0%, and all O's are 
changed to 1's. 

To obtain the two's complement of a binary number, just add one (1) to 
the one's complement of the number as shown in the following examples. 
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1. The number —————» 10011101 
Опе” complement ——»- 01100010 
Add one +1 


Two's complement ———> 01100011 


2. The number —————» 10011100 
One's complement ——» 01100011 
Add one | + J 


Two's complement ——»5- 01100100 


3. The number — — —»* 01010101 
One's complement ——» 10101010 
Add one + 1 


Two's complement ——> 10101011 


Now let's see how the computer uses the two's complement in a subtrac- 
tion problem. Compare it with our paper-and-pencil subtractions above. 


Examples: 
1. 10101101 
- 00100101This number is changed to its 
11011011 two’s complement 


Then the two’s complement is added to the original number. 
10101101 
+ 11011011 


1 10001000 


SN анн 
"Es 88 HEX or 136 decimal 


Extra bit 
2. 00111100 
- 00100011 
Two's ( - 00111100 
complement 1101110041 ——» *11011101 
1 00011001 19 HEX or 25 decimal 
Ignore ` | E 
Extra bit 


If the computer's method of subtraction is puzzling to you, relax! You 
don't have to worry about how it does the subtraction. You can check the re- 
sults by the old paper-and-pencil method. 

Let's try a subtraction in a machine language program. By changing two 
instructions in our original Addition program, we will have: 
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SUBTRACT TWO NUMBERS 
1. REMARK * SET THE CARRY BIT * 


300 38 SEC (SEt the Carry bit) 
2. REMARK * LOAD AND SUBTRACT TWO NUMBERS * 


301 A9 LDA3C (Load the first number) 
302 3C 


303 E9  SBC23 (subtract the second number) 
304 23 


3. REMARK * DISPLAY RESULT AND RETURN TO BASIC * 


305 20 JSR FDDA (display the result) 
306 DA 
307 FD 


308 60 RTS (Go back to Monitor) 


In Section 1, the Set Carry Bit instruction is used to place a one (1) in the 
carry bit of the status register. In subtraction, the carry bit is used to obtain the 
two's complement of the number to be subtracted. Therefore, SEC (SEt Carry 
flag) is given before the subtraction is performed. The Op code for SEC is 38. 
The instruction is only used in the Implied mode. 

In Section 2, the first number is loaded in the accumulator. Then the SBC 
(SuBtract with borrow) instruction is used in the Immediate mode (Op code 
E9). The two's complement of the number immediately following the instruc- 
tion is added to the number in the accumulator. The result of the subtraction 
(or two's complement addition) is left in the accumulator. 

Section 3 displays the results as before and returns to the System Monitor. 

Enter the program with the System Monitor. 


*300:38 A9 3C E9 23 20 DA FD 60 


ж 


Then run the program. 


*300:38 A9 3C E9 23 20 DA FD 60 


*ш The result 19 (HEX), just like pencil and paper 
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Try other numbers at locations 302 and 304. Be sure that the number used 
at 302 is larger than the number that you are subtracting (at 304) if you want 
positive results. 


O.K. wise guy! 
What if | don't want 
positive results? 


| thought you'd neve? 
ask. Negative results will 
be discussed in Chap. 9. 


We have restricted our discussion so far to positive numbers that can be 
expressed in 8 bits (one byte). These numbers are less than 256 (100HEX). In 
the next chapter we'll take a look at negative numbers and at positive numbers 
that may be larger than 255. 


SUMMARY 


The System Monitor was introduced along with the following symbols and 
commands. 


Ы The System Monitor prompt 

*300:A9 Modify a single memory location 

*300:A9 13 8D 25 3 60 Modify successive memory locations 
Used in entering new programs 


*300 Examine a single memory location 

*300.305 Examine memory locations 300 through 
305 (HEX) 

*300G Execute the machine language program be- 
ginning at memory location 300 
(HEX) 


You also learned to enter an addition program that added 2 one-byte HEX 
numbers and displayed the result. The carry bit was used to detect results that 
were larger than could be held in a single byte. 

Subtraction by means of two’s complement addition was demonstrated. 

The individual bits in the Processor Status Register were discussed. . 


IN v| [Bjo] i[z]C| 


Several new instructions were introduced. 
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7. What is the one's complement of 10110011? 
. What is the two's complement of 01101101? І 
If the Subtract Two Numbers Program is used to subtract 23 (HEX) from 


10. 


Mnemonic | Addressing | Op | Bytes 
Code Mode Used Function 


Implied 1 Clear the carry flag 
Immediate 2 Add immediate data to 
accumulator 


Relative 2 Branch on carry set 
Relative Branch on carry clear 
Absolute Add contents to memory 
to accumulator 
Immediate Subtract immediate data 
from accumulator 
Implied Set carry flag 


EXERCISES 


. Name the mnemonic codes for the instructions Add with carry and Subtract 


with borrow. 
and 


. The Add with carry instruction adds a number to the value in the accumula- 


tor. It also adds in what other value? 


———————— —— ——————————————— 


. If the HEX values 35 and 6A are added by the Add Two Numbers Program, 


what value will be displayed? 


. If the HEX values 85 апа 9A аге added by the Add Two Numbers Program, 


what value will be displayed? 


. If the Modified Addition Program is used to add the HEX numbers 85 and 


9A, what value would be stored in: 
0330 


. In exercise 5, what would be displayed after the program has been run? 


AF (HEX), what would be displayed when the program is run? 


What would be the result of A3 - 2F (HEX values)? 
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ANSWERS TO EXERCISES 


. ADC and SBC 

. The value in the carry bit 

. 9F (HEX) 

. 1F (HEX) (The actual result is 11F, but the carry bit is not displayed.) 
. 0330 = ТЕ 

. ОТТЕ (HEX) 

. 01001100 

. 10010011 

. 8C (HEX) 

. 74 (HEX) 
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Chapter 9 


Multiple Precision and 
Negative Numbers 


[sw | 


In order to handle large numbers, it is necessary to work with values in 
multiple bytes. We will consider two-byte numbers in this section. If we restrict 
ourselves to positive numbers, two bytes can provide for numbers as large as: 


11111111 11111111 = FF FF HEX 
—„— | 


num, eee” 
РЕ Xx -— 
Most Significant Lease Significant 
Byte Byte 


(15X4096) + (15X256) + (15X16) + 15 


— 


3840 
240 
+ AS 


65,535 decimal 
Largest decimal number for two bytes 


FF FF HEX 


Larger values can be obtained by extending the number of bytes as desired. 


TWO-BYTE ADDITION 


Two Bytes are Better than One 
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A paper and pencil addition of two-byte numbers will help us decide how 
to write a program to perform the operation on the computer. Suppose we want 
to add these two-byte HEX numbers. 


Most Significant Least Significant 
Byte / ^A Byte 


01010101 10100100 
00111100 10110011 


55A4 
* 3CB3 


The binary addition 01010101 10100100 
by bytes ———» + 00111100 10110011 -— LSB first 


1 01010111 


С 
Extra Least Significant Byte (LSB) 


is in the carry bit of result 


Then MSB 01010101 10100100 
* 00111100 10110011 


* 1 01010111 ~—— From LSB 
- 10010010 
м“ 


Most Significant Byte (MSB) 
of result 


MSB LSB 
The final result - 10010010 01010111 


9 2 5 7 HEX 
Notice that in this example a carry results from the addition of the Least Signif- 
icant Bytes. The ADC (ADd with Carry) instruction will automatically add in 


this carry bit to the sum of the Most Significant Bytes. Therefore, it appears that 
the two-byte numbers are summed by adding: 


First, the Least Significant Bytes and 
Second, the Most Significant Bytes. 


If we draw a flowchart of the operations that must be performed, it will 
help us write the program step by step. 
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FLOWCHART 


SYSTEM 
MONITOR 


Clear carry bit 


Load accumulator with 
LSB of 1st number 


Add LSB of 2nd number 


Store LSB of result 
in memory 31B 


Load accumulator with 
MSB of 1st number 


Add MSB of 2nd number 


Store MSB of result 
in memory 31A 


It looks like a very straightforward program. We'll set up a block of mem- 
ory to store the bytes that are to be added and the bytes of the result of the 
addition. Since there are 2 bytes for each number, we'll set aside 6 bytes. 


Memory locations Value stored 
316 LSB of 1st number 
317 MSB of 1st number 
318 LSB of 2nd number 
319 MSB of 2nd number 
31A MSB of result 
31B LSB of result 


These bytes are 
reversed for 
convenience of display 


By looking at the flowchart, we can write the program. 
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TWO-BYTE ADDITION 
1. REMARK * CLEAR THE CARRY BIT * 


300 18 CLC 


2. REMARK * LOAD, ADD AND STORE LSB * 


301 AD LDA, 0316 -—— Load LSB of 1st number 
302 16 
303 03 


304 6D АРС, 0318 ~— Add LSB of 2nd number 
305 18 
306 03 


307 8D STA, 031B ~— Store result of LSB 
308 1B 
309 03 


3. REMARK * LOAD, ADD AND STORE MSB THEN RETURN * 


30A AD LDA, 0317 ~<— Load MSB of 1st number 
30B 17 
30C 03 


30D 6D АРС, 0319 -«— Add MSB of 2nd number 
30E 19 

30F 03 

310 8D  STA,031A -«— Store result of MSB 

311 1A 

312 03 


313 60 RTS 7*— Go back to Monitor 


4. REMARK * DATA * 


314 00 BRK Filler 

315 00 BRK Filler 

316 A4 -—- LSB 1st number 

317 55 ~— MSB 1st number 

318 B3 ~— LSB 2nd number 
319 3C ~— MSB 2nd number 
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Notice that we used the LDA and ADC instructions in the Absolute mode this 
time. The Op code for LDA when used in this mode is AD. The Op code is fol- 
lowed by the least significant byte of the address containing the data to be 
loaded. The most significant byte of this address follows as the third byte of the 
instruction. 


AD «—— Op code for LDA (Absolute mode) 
16 ~— Least Significant Byte of address 
03 ~— Most Significant Byte of add -sss 


The Op code for ADC in the Absolute mode is 6D. The Op code is also followed 
by the address containing the number to be added. The Least Significant Byte 
of the address is given, then the Most Significant Byte. 


6D ~—— Op code for ADC (Absolute mode) 
18 -—— Least Significant Byte of address 
03 ~— Most Significant Byte of address 


In our paper-and-pencil addition, we calculated a result of 9257 HEX. 
Let's let the computer have a try at it. 
First, enter the program. 


*300:18 AD 16 03 6D 1803 8D 1B 03 AD 17 
03 6D 19 03 8D 1A 03 60 00 00 A4 55 B3 
3C 


ттн ae 


жщ All entered 


Then run it. 


.*300:18 AD 16 03 6D 1803 8D 1B 03 AD 17. 
03 6D 19 03 8D 1A 03 60 00 00 A4 55 B3 
3C 


*300G «————————————————— КОМ 


| 
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Then examine memory locations 31A and 31B to see the results. 


*300:18 AD 16 03 6D 18 03 8D 1B 03 AD 17 
03 6D 19 03 8D 1A 03 60 00 00 A4 55 B3 
3C 


*300G 
*31A.31B 


031A- 92 57 -«——— There it is — the same as with pencil and paper 
*и 


TWO-BYTE SUBTRACTION 


Subtraction of two-byte numbers is performed in a similar manner. The 
Add Two Numbers Program can be modified by three simple changes: 


at 300 change 18 (CLC) to 38 (SEC) ~— Set the carry bit 


and 


at 304 | change 6D (ADC) to ED (SBC) «—— Subtract with borrow 
at 30D 


The change at 300 sets the carry bit in preparation for the subtraction just 
as it did in the one-byte subtraction program. The Add with carry instruction 
(ADC) is replaced by the Subtract with borrow instruction (SBC). The subtract 
instruction is used in the Absolute mode with the address that contains the num- 
ber to be subtracted following the Op code. 


ED ~—— Op code for SBC (Absolute mode) 
18 ~—— Least significant byte of address 
03 ~—— Most significant byte of address 


Thus, the least significant byte of the value to be subtracted is contained 
in address 0318 HEX. The most significant byte of the value to be subtracted is 
contained in address 0319 HEX. It is subtracted from the most significant byte 
of the first value by the instruction: 


ED ~—— Op code for SBC (Absolute Mode) 
19 ~—— Least Significant Byte of address 
03 ~—— Most Significant Byte of address 


You have two choices. 
(a) If you still have the two-byte addition program in memory, just 
make the three changes. 
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* 300:38 
*304:ED 
*30D:ED 


*и 


(b) If you do not have the two-byte program in memory, enter the new 
program with the changes. 


*300:38 AD 16 03 ED 18 03 8D 1B 03 AD 17 
03 ED 19 03 8D 1A 03 60 00 00 A4 55 B3 
3C 


a 


Then run the program. 


Then examine the memory locations that hold the result. 


*300G 


*31A.31B 


031A-18 ЕТ —————— Answer 
/ жщ 


55A4 = 0101 0101 1010 0100 
- 3CB3- 0011 1100 1011 0011 


0001 1000 1111 0001 binary 


= 1 8 F 1 HEX-—— Yes, it checks! 
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(1X16?) + (8X16) + (15X16) +1 


4096 + 2048 + 240 * 1 


6385 Decimal 


To add or subtract numbers that require more than two bytes, an exten- 
sion of this two-byte procedure can be made. The Operation is always performed 
from the least significant byte forward (or from right to left). 


MULTIPLE-BYTE ADDITION FLOW 


1. | Clear carry bit 
2. Load LSB of 1st number 
Add LSB of 2nd number First 
Store result. Byte 
3. Load next byte of 1st number 
Add next byte of 2nd number ‚ Second 
Store result. Byte 


4. Repeat Step 3 until all 
bytes have been stored away. 


Load MSB of 1st number 


5. 
Add MSB of 2nd number 
Store result 

6. Back to the Monitor 


NEGATIVE NUMBERS 


It is possible to look at the way data is represented in the computer in a 
different way. If signed numbers (those that are either positive, negative, or 
zero) are to be represented, the computer must have some way to tell them 
apart. 
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Consider an 8-bit block of data as being composed of one sign bit and 
seven data bits. 


DU qc Net ае E "p 
Sign Кел 7 Data 


positions 


(a) If the sign position holds a zero, the data is considered to be a positive 


number. 

Examples: 
0111111 1 = +127 (64+32+16+8+4+2+1) 
01111110 = +126 (64+32+16+8+4+2 ) 
01111101 = +125 (64+32+16+8+4 +1) 
01111100 = +124 (64+32+16+8+4 ) 
00000011 = +3 ( +2+1) 
00000010 = +2 ( +2 ) 
00000001 = +1 ( +1) 
00000000 = +0 ( ) 


V Zero is considered a positive number 
by Branch Instructions 


(b) If the sign position holds a one (1), the data is considered to be a negative 


number. 

Examples: 
10000000 =-128 
10000001 =-127 
10000010 --126 
10000011 72-125 
10000100 =-124 
11111011 --5 
11111100 =-4 
11111101 2-3 
11111110 =-2 
11111111 --1 
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We have learned to interpret positive binary numbers as positive decimal 
numbers, but what about these negative critters? They don't look familiar at 
all. However, it is plain to see that each 8-bit code could represent all the inte- 
gers from -128 through *127. 


00000000 = +0 Zero and 
00000001 = +1 above 
positive 
0 
Positive 
ees 


01111110 = +126 
01111111 = +127 
10000000 = -12 
10000001 = -127 
10000010 = -126 


Negative id | Below zero 
T negative 


11111110 = -2 
11111111 = -1 


Let's take a look at the negatives and see if there is any meaningful rela- 
tionship to their positive counterparts. | 
Consider the positive number 126 = 01111110. 
Its one's complement = 10000001 
Its two's complement - 10000010 
Compare the latter with -126 = 10000010 


The binary representation of a negative number (-1 through -127) is equal to 
the two's complement of its positive counterpart. 


-127 = the two's complement of +127 
-126 = the two’s complement of +126 
-125 = the two's complement of +125 


-2 = the two's complement of +2- 
-1 =the їмо” complement of +1 | 
For two-byte numbers, the sign position is considered to be in the most 
significant bit of the most significant byte. 


Most Significant Byte _ Least Significant Byte 
“ARPA РЕРЕРЕН 
Li J 
Sign 15 Data bits 


position 
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A complete discussion of the arithmetic of signed numbers is beyond the 
scope of this book. A more thorough discussion of signed numbers and signed 
number arithmetic can be found in the MOS Technology Programming Manual 
available in some computer stores or from MOS Technology, Inc., 950 Ritten- 
house Road, Norristown, PA 19401. 

For our purposes, we must realize that certain branch instructions test the 
result of numbers to see whether they are negative or positive. This determina- 
tion depends on whether or not the Negative flag of the Processor Status Regis- 
ter has been set to a 1. The Negative flag is set to 1 when the computer inter- 
prets the results of certain instructions as negative numbers (a result of 1 in bit 
7). We will stress this fact in the recreational activities that follow. 


A NUMBER GUESSING GAME 


You probably have seen this game many times in books and magazines. It 
is usually published in BASIC. We will show a machine language version that 
makes use of the two-branch instructions that are based on an interpretation of 
signed numbers. This interpretation hinges on the negative flag (or bit) in the 
Processor Status Register. 


BMI (Branch on result minus) Branch if the 
negative flag is 
Op code = 30 set to 1 (negative 
result) 


Relative Addressing mode 


BPL (Branch on result plus) Branch if the 
| negative flag is 
Op code = 10 | reset to O (positive 
result) 


Relative Addressing mode 


We will also use the branch on result equal instruction, which makes use of 
the zero flag in the Processor Status Register. 


BEQ (Branch on result equal) Branch if the 
zero flag is 
Op code = FO set to 1 (result 
equal zero) 


Relative Addressing mode 


Bit position 6,5,4,3,2 Processor Status Register 
et tt tt tet | 
4 
Used for S Used for 


BMI and BPL | BEQ and BNE 
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FLOW OF NUMBER GAME PROGRAM 


1 Get random number 
Store it 
Clear Screen 


- Get first digit of guess 
Shift it left 
Get second digit of guess 
Add to first digit | -4 
Store result in 0354 


Load computer's number 
Compare with guess 

Go to appropriate 
response 


Display a - if 
guess is low 
Go back for new guess 


Display a * if 
guess is high 
Go back for new guess 


Display *** and 
ring bell if guess 
is correct 

Go back to Monitor 


Display a ? prompt 

Get one digit of 4— 
guess 

Go back to main 

program 


Many useful subroutines are used from the System Monitor by the pro- 
gram. Without these subroutines, the program would take several pages to list 
and would become quite complex. You should study the Apple I! Reference 
Manual thoroughly so that you can take advantage of these subroutines when- 
ever possible. The manual is available from Apple Computer, Inc., 10260 Band- 
ley Dr., Cupertino, CA 95014. (Apple product number A2L0001A). 
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Let's look at the program in detail. If you understand how it works, you 
will be able to modify it as you wish. We have provided the fundamental pro- 
gram, but you may provide numerous additions. 


Section 1 


Get a random number 
Store it 


Clear the screen 


300 20 1B FD JSR FDIB Get Random number 
303 А5 4F LDA,4F Read it 

305 29 7F AND 7F Strip upper bit. 

307 8D 53 03 STA 0353 | | Store it 

30A 20 58 FC JSR FC58: Clear screen 


We first make use of the KEYIN subroutine at FD1B. It reads the key- 
board and waits for a keypress. When a key is pressed, a random number is 
placed in memory location O04F. The keycode for the character typed is placed 
in the accumulator, but our program ignores this code. We are inter- 
ested only in the random number that is generated. The random number is 
loaded in the accumulator from 004F. It is ANDed with 7F. This restricts the 
random value to a positive HEX number in the range of 0 through 7F. Remem- 
ber, the computer would interpret 80 through FF as negative numbers. Let's 
stay away from those. If we included ерү, the program would get much 
more complicated. 

Remember the AND instruction from Chap. 7? This time we are using 
it to “strip off" the upper bit of the random number to make sure the com- 
puter does not produce a negative number. 


Example: Suppose the random number was F3 (a negative). 
F3 = 1111 0011 
0111 1111 AND with 7F 
0111 0011 = 73 a positive number 


The number produced has ones in only the 
bits where both F3 and 7F have ones. 


The random number is then stored in memory location 0353. We will re- 
call it later to compare it to the number guessed. The screen is then cleared, by 
the monitor routine at FC58, in preparation for the guessing portion of the 
program. 
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Section 2 


Jump to subroutine (Section 7) 
to get 1st digit 

Shift it left 4 times and 
save it in memory 

Jump to subroutine (section 7) 
to get 2nd digit 

Add the two digits | 

Store the guess in memory 


30D 20 55 03 JSR 0355 
310 OA 0A OA ASL 

313 OA 

314 8D 54 03 STA 0354 
317 20 5A 03 JSR 035A 
31A 18 CLC 

31B 6D 54 03 ADC 0354 
31E 8D 54 03 STA 0354 


Get first digit of guess 
Shift left four times 
Store first digit 

Get 2nd digit of guess 


Combine 2 digits 
Store it back 


At 30D, a subroutine (see Section 7) is called that displays a question 


mark as a prompt to let you know that the computer is waiting for your guess 
(a two-digit HEX number less than 80). 


The subroutine allows the entry of one digit of your two-digit guess, modi- 


Suppose that you enter a 5: 


fies its ASCII code, and then returns to 310, where the value is shifted left 4 
places. 


гоо [оо[о[т[о[т Accumulator before the shifts 
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7161541312110 
i0|1]0| 1[0[0/0/0 Accumulator after the shifts 


wee “eee —Qnuá 


Bits 32,10 \ 4 eros inserted 
were shifted 


to positions 7,6,5,4 
respectively 


This result is stored in memory location 0354 as 50 (HEX). At 317, the 
subroutine (Section 7) is called again to get the second digit of the guess. The 
subroutine modifies the ASCII code of that digit and returns to the main pro- 
gram at 31A. 

The first digit is now added to the second digit. 

Suppose that your second digit was 7. 


00000111 Accumulator (second digit) 
+ 

01010000 From memory 0354 

01010111 The two-digit guess 


The guess is then stored back in memory location 0354. 


Section 3 


Put computer’s number in accumulator 
Compare computer’s number with guess 
If equal goto Section 6 

If guess is too big goto Section 5 
If guess is too small go on to Section 4 


321 AD 53 03 LDA 0353 Load computer's number 
324 CD 54 03 CMP 0354 Compare with guess 

327 FO 12 BEQ 12 If = goto 033B 

329 30 08 BMI 08 If guess is high goto 0333 


The computer's number and your guess are compared. If the result is 
equal, the BEQ instruction at 327 sends the program to 338 (Section 6) to dis- 
play the victory message. If the guess is too high, the comparison (computer- 
guess) is negative, and the BMI instruction at 329 sends the program to 333 
(Section 5) to display a * sign and go back for a new guess. If the guess is too 
low, the program proceeds to Section 4. 
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Section 4 


Display a - sign 
Go back to Section 2 
for a new guess 


32B A9 AD LDA 4AD Load (-) 


32D 20 ED FD JSR FDED Display it 
330 4C 0D 03 JMP 030D Go back for new guess 


A minus sign is displayed to indicate the guess was too low. The program 
then jumps back to get the first digit of the new guess. 


Section 5 


Display a + sign 
Go back to Section 2 
for a new guess 


333 A9 AB LDA #AB Load (+) 
335 20 ED FD JSR FDED Display it 
338 4C OD 03 JMP 030D Go back for new guess 


A plus sign is displayed to indicate the guess was too high. The program 
then jumps back to get the first digit of the new guess. 


Section 6 


Display *** 


Ring the bell 3 times 
End the game — 


33B 20 8E FD JSR FD8E RETURN the carriage 
33E A9 АА LDA AA Load (*) 

340 20 ED FD JSR FDED Display it 3 times 
343 20 ED FD JSR FDED 

346 20 ED FD JSR FDED 

349 20 3A FF JSR FF3A Ring bell 3 times 

34C 20 3A FF JSR FF3A | 

34F 20 3A FF JSR FF3A 

352 60 RTS Go back to Monitor 
353 00 00 | Storage for data 


This is the victory message. Three asterisks are displayed followed by three 
rings of the bell (Monitor subroutine at FF3A). Control is then returned to the 
Monitor. Location 353 and 354 are used to store the numbers (random and 
guess). | 
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Section 7 


Display a ? prompt for guess 
Get digit and display it 
Make sure it is a HEX digit 
Change to proper form 
Return to main program . 


This subroutine is entered after the random number has been selected in 
Section 1. A question mark is displayed to prompt you to make your guess. The 
first digit is displayed after being typed. The subroutine then goes through a 
series of tests to make sure that the digit has an ASCII code in the range of BO- 
B9 for the decimal digits 0,1,2,3,4,5,6,7,8,9 or C1-C6 for the letters A,B,C,D,E, 


F. This allows for the entry of the complete set of HEX digits. 


355 А9 BF LDA 4BF | Load (?) as prompt for guess 
357 20 ED FD JSR FDED Display it 

35A 20 35 FD JSR FD35 Get digit 

35D 20 ED FD JSR FDED Display it 

360 C9 BO CMP #80 Tests for legal HEX digits 
362 30 15 BMI 15 If low go to 379 

364 C9 BA СМР #BA | 

366 30 OE BMI OE In range BO-B9 goto 376 
368 C9 СЇ CMP #С1 

36A 30 OD BMI OD Between B9 and C1 goto 379 
36C C9 C7 CMP #C7 | 

36E 10 09 BPL 09 If too high, goto 379 
370 29 OF AND #0F Strip off upper bits (C) 
372 18 CLC 

373 69 09 ADC #09 Change to (A-F) 

375 60 RTS Return to main program 
376 29 OF AND #0F Strip upper bits (B) 

378 60 RTS Return to main program 
379 20 3A FF JSR FF3A Ring bell bad input 

37C 20 8E FD JSR FD8E Carriage return 

37F 4C 55 03 JMP 0355 Give another prompt 


If a key out of the acceptable range is typed, a bell rings and the com- 
puter displays a new question mark prompt. If the keystroke has an ASCII 
code in the BO-B9 range, the BMI instruction at 366 sends the computer to 
376, where the B of the ASCII code is removed by ANDing with OF. The com- 
puter then returns to the main program with the adjusted value in the accumu- 
lator. If the keystroke has an ASCII code in the C1-C6 range, the AND instruc- 
tion at 370 strips off the C. Nine is added to the remaining value to produce 
a HEX digit A-F. The computer then returns to the main program. . 
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Now we're ready to enter the program. Use great care! This is a long pro- 
gram. Take your time. Try entering it in sections and examining memory after 
each section is entered. 


*300:20 1B FD A5 4F 29 7F 8D 53 03 20 58 

FC 20 55 03 OA OA OA OA 8D 54 03 20 5A 
03 18 6D 54 03 8D 54 03 AD 5303 CD 540 
3 FO ~~ Enter 


*300.327 


0300- 20 1B FD A5 4F 29 7F 8D +————— Check 
0308- 53 03 20 58 FC 20 55 03 

0310- ОА ОА OA ОА 8D 54 03 20 

0318- 5A 03 18 6D 54 03 8D 54 

0320- 03 AD 53 03 CD 54 03 FO 


*- 


Then 


*328:12 30 08 A9 AD 20 ED FD 4C OD 03 A9 
AB 20 ED FD 4C OD 03 20 8E FD A9 AA 20 
ED FD 20 ED FD 20 ED 


*328.347 


0328- 12 30 08 A9 AD 20 ED FD 
0330- 4C 00 03 A9 AB 20 ED FD 
0338- 4C OD 03 20 8bE FD A9 AA 
0340- 20 ED FD 20 ED FD 20 ED 


Ci 
Then 
*348:FD 203A FF 203A FF 203A FF 60 00 


00 A9 BF 20 ED FD 20 35 FD 20 ED FD C9 
BO 30 15 C9 BA 30 OE 


*348.367 


0348- FD 20 3A FF 20 3A FF 20 
0350- 3A FF 60 00 00 A9 BF 20 
0358- ED FD 20 35 FD 20 ED FD . 
0360- C9 BO 30 15 C9 BA 30 OE 


k 
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Last of all 


*368:C9 C1 30 OD C9 C7 10 09 29 OF 18 69 
09 60 29 OF 60 203A FF 20 8E FD 4C 55 
03 


*368.381 


0368- C9 C1 30 OD C9 C7 10 09 
0370- 29 OF 18 69 09 60 29 OF 
0378- 60 20 ЗА FF 20 8E FD 4C 
0380- 55 03 


*- 
Check over your entries. Make sure that some of those zeros did not turn 


out to be capital letter O's. Gather up your courage and try a run. Here is one of 
our typical runs (after we found and corrected all of our typing errors). 


9 OF 60 20 3A FF 20 8E FD 4C 55 03 
*300G 
When you press the return key, the cursor disappears and nothing seems to 


happen. The computer is now generating a random number. When you press any 
key, the process will stop, and the computer will have a random number. So... 


press a key. 


1. PRESS ANY KEY. 
a 


е it has the random number and wants a guess. 


We typed 40 


— The guess was too high Ready for a new guess 


We typed 20 


| ?40*?20-?u 
The guess was too low 
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We typed 30 


| 240*?20-?30:?m 
X The guess was too high 


We typed 28 


| ?40*220-23042284?m 
ы. 


We typed 24 


Still too high 


?40+?20-?30+?28+?24 
TK o — — Three bells rang and 3 asterisks appeared on 
*и the screen. The number was 24! 


“a Ding In 5 guesses! 
Ding 


Ding 


Let’s try one more round to see what will happen if we input some non- 
HEX characters. 


Type 300G for another round with a new number. 


?40*?20-2304?28*?24 
Жжж 


*300G 


Type any key and a random number is again chosen. The screen is cleared 
and a ? appears. 


?m 
| аў for a new guess 


Here are some results of inputs that are not hexadecimal. 


?N 
? 


ш 
the N was not accepted. A new ? appears. 


ON 


he 1 was accepted but not the V 
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?N 
MV 
?)4-?m 
T The 4 was accepted. The value 14 is shown to be too low 
by the - sign. 


?М 
23V 
24-?40-?m 

40 is also too low 


2N 
?1V 

?4-?40-?60-60-?ш 

60 also too low 


2N 
21V 
24-240-260-270+2™ 


70 is too high 


?N 
?1V 

?24-?40-?60-?70*?68 

koe -c Bells and asterisks again. 68 is the number. 
xm 


Let’s check the memory and see if the two numbers really match. 


Жжж 


*353.354 


0353- 68 68 


Yes they match. 
*. 
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SUMMARY 


In this chapter you learned that two-byte addition could be performed by 
formatting large numbers into two separate bytes. The same proved true for the 
subtraction of two-byte numbers. This procedure can be extended to higher 
multiple-byte arithmetic. 

Demonstration programs were given for two-byte addition and subtrac- 
tion. You had a chance to practice examining and modifying memory contents 
by means of the System Monitor. 

You learned that the format for signed numbers is: 


зз о 
тиииш 


ENNENENE 
sign „7 data bits 


Two-byte numbers: 


Single-byte numbers: 
Bit position 


Bit position Heys asta це tafe ts taps fatto 
ШШШ ШИЕ ШЕ И ШШ Ж 
sign bit | data bits 


You also learned to interpret negative binary numbers to decimal equiva- 
lents by using the two's complement procedure. 


A number guessing game used decisions based on signed numbers. 


New Instructions Used 


Mnemonic | Adaressing Op | Bytes 
Code Mode Code | Used Function 


ADC Absolute 6D Add contents of memory to 
| accumulator 


SBC Absolute Subtract contents of memory 
from accumulator 

LDA Zero Page Load accumulator from zero 
page memory (00XX) 

CMP Absolute Compare accumulator contents 
and contents of memory 


New Subroutines Used 


Function | | Location in Memory 


KEYIN to get a random number FD1B 
CROUT to execute a carriage return FD8E 
BELL1 to ring a bell FF3A 
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10. 


EXERCISES 


. What is the 4-digit HEX representation of the following two-byte unsigned 


binary value? 


011011111/10100011 |= ———— ———— (НЕХ) 
_—„—— 


Ne 
most significant least significant 


byte byte 


. The Two-Byte Addition Program added 55A4 and 3CB3 HEX. Show how 


to modify the program to change these two values to 5A45 and 3B3C HEX. 


и 


. If the Two-Byte Addition Program was executed with the modifications of 


Exercise 2, what result would be displayed by the following command? 
*300G 


*31A.31B 


. In two-byte subtraction, which byte is operated on first? 


(most, least) 
significant byte 


. Subtract 03C5 from 25A2 (HEX). Use a computer program, two's comple- 


ment addition, or pencil-and-paper method. 
Result = (HEX) 


. What is the bit position used to interpret signed numbers? 


. What would be the decimal interpretation of the signed number 10111010? 


. If the computer selects a random HEX number of 6D and you input a guess 


of 40 when running the Number Guessing Game, what will the display 
show? 


240 


. If a random number of 9E is generated at location 300 of the Number 


Guessing Game, what number will be stored in memory location 353? 


If the first digit of a guess in the Number Guessing Game is 7 and the 
second digit has not been selected, what value is stored in memory loca- 
tion 354? (Hint: See Section 2 and Section 7 of the program.) 
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ANSWERS TO EXERCISES 


. 6FA3 


| *316:45 5А ЗС ЗВ Or 


*316:45 


*317:5A 
*318:3C 
*319:3B 
| 031A- 95 81 
. Least 
. 21DD 
. Bit 7 of the most significant byte 
-70 
| 240-? 
TE (9E ANDed with 7F =1E 


. 70 (the value was shifted left 4 times) 
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1001 1110 
0111 1111 


0001 1110 1E) 


Chapter 10 


More Monitor Magic 


We have relied on pencil and paper to check the results of hexadecimal ad- 
ditions and subtractions. Computers are made to take over the drudgery of 
tedious tasks, and pencil-and-paper hexadecimal arithmetic is surely a tedious 
task. It's also highly subject to errors. 

The Monitor will perform simple hexadecimal addition and subtraction of 
two-digit hexadecimal numbers. You just type in the values separated by the 
operation symbol. It is not necessary to write a program to do the operation. 


HEXADECIMAL ADDITION — IMMEDIATE MODE 


(0 V 


Here is the method used. It's almost like using a calculator. 


*3C+2F <«~—— You type this 
=6B 44— — — Computer responds 
+ 


*59+C -«——— Y ou type this 
=65 <———————— Computer responds 
xE 


You may notice that our addition examples produce a result that is less than 
FF. What do you suppose happens if the result is larger than FF? Try it. 


*FF+13 


=12 
*- ть result is less than either addend. Why? 
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Look at the binary addition of FF and 13 to discover the reason. 


FF= 1111 1111 
132 0001 0011 
Lim 0010, -«—— — The real answer is 112 
One bit too many N There's the result displayed 


to fit in the 
accumulator 


This feature of the monitor is restricted to display the results of the addi- 
tion of two-digit values whose sum is FF or less. However, you can use the 
addition feature for sums greater than FF if you keep track of this extra bit. 

You can even use the addition feature for multiple-byte addition if you 
keep track of the extra bit that must be “саггіеа over” to the next place. 


Example: Add 35D and 2F5 


First, separate the bytes: 3 5D 
2 F5 


Second, add the low-order bytes: 


*5D--F5 
7-52  -«— —— Low-order result, but there was a carry — don’t lose it. 
*щ 


Third, add the high-order bytes and the carry. 


*342 
-05  -—— —- Temporary high-order result 
*5+1 -«— —— Add carry 

-06 

*- ^ —— Final high-order result 


Therefore, the final result is: 35D+2F5 = 652 


The third step has to be done in two parts since the immediate addition 
and subtraction will only operate on two values. If you try to add three values, 
the second value will be ignored. Only the first and last values will be added. 


Examples: 
*3+2+1 
=4 -— Actually 3+1 


*1F+2F+1 
=20 -———Асїша!у 1F+1 


*2A+11+37 
=61 + ——Actually 2A+37 
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Here are some other examples: 


1F30 * 25C8 


*30+C8 


=F8 -«— —- Low order — no carry 
*1F425 

-44 *— — — —- High order — no carry 
*- 


Therefore, 1F30+25C8 = 44F8 


1F33 * 2FF5 


*33+Е5 


=28 -——— Low order — carry 1 
*1Е+2Е 
=4Е +———— Temporary high order 


*4E+1  -«— — Ааа carry 
=4F ^ -— —————— Final high order 
*- The result is 4F28 


It is possible to exceed a two-byte result, as shown in this last addition 
example. 


D14F + E213 


*4F+13 


=62 -«— — —Lovw order — no carry 

*01+Е2 

=B3  -«— — Ніеһ order, but there is а carry. 
+m 


The answer is really: 1B362 
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If you are going to use the hexadecimal addition feature of the Monitor 
when results are larger than a single byte (FF maximum), you must be able 
to estimate results so that you will know when a carry occurs. 


HEXADECIMAL SUBTRACTION {№ АА y 


Subtraction may also be performed with similar precautions. Here are 
some examples. 


3D - 28 


*3D-28 -*—— You type 
=15 — — — — Computer responds 
Ж 


А4 - 2D 
*A4-2D ~——You type 


=7] -———————— Computer responds 
Ж 


It looks easy, but what happens if you try to subtract а large number from 
a smaller one? 


22-24-2?? 


*22-24 
-FE -———— — That's what it says. 
* 


If your algebra is not too rusty, you know that you get a negative value when 
large positive numbers are subtracted from smaller positive numbers. Could 
FE be a negative number? Yes. Look back to the negative number table in 
Appendix B. FE is equivalent to the signed number -2. 

You could use subtraction to create a table of negative values for future 
reference. For example, 


*0-1 and *0-4 
-FF -FC 


You can omit the O as an entry value if you wish. Try entering: 


*-] and *_4 
=FF =FC 
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Now create a table of negatives. 


Table of 
Negatives 


Subtraction can come in very handy when calculating the operand used in 
branch instructions. Turn back to "Description of the Program" in Chap. 7, and 
check the branch instructions used there. 

At 776 and 777 of the Play Your Own Tune Program, we used F9 for a 
backward branch of -7. At 782 and 783, we used F3 for a backward branch of 
-13. Let's check these values. 


or 


Remember, D is the HEX 
equivalent of -13 


They do check. 


207 


DECIMAL ARITHMETIC 


Are you tired of converting binary to HEX to decimal? If so, the 6502 in- 
struction set includes an instruction to help you out. If you are careful to 
express the values that you wish to add or subtract as binary-coded decimal | 
(BCD) numbers, the Apple can add or subtract those numbers and express the 
result as a decimal value. What are binary-coded decimal numbers? That's just a 
fancy name for a binary number that has been separated into two 4-bit parts. 
These parts are then interpreted as decimal digits. 


Binary-coded decimal 


Examples: 


01011000 0101 1000 58 
10010011 1001 0011 93 
00010110 0001 0110 16 


Since each 4 bits are interpreted as a decimal digit, the binary inputs must 
be chosen with care. 


11001001 1100 1001 
NOT a BCD value 


10101011 1010 1011 


NOT BCD values 
Each 4-bit part must be one of these: 


BCD DECIMAL 


Е 
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The instruction needed to request the computer to perform decimal 


addition or subtraction is: 
SED (SEt Decimal mode) 


Op code = F8 
Implied Addressing Mode 
One byte long 
Status flags affected - D 


This instruction sets the decimal flag in the Processor Status 
Register to 1. Once this instruction has been used, all of the 
Add and Subtract instructions will be carried out as decimal 
operations because of the status of the decimal flag. The oper- 
ation of any of the other instructions is not affected. If the 
SED instruction has been executed in a program, and a binary 


21) 


addition or subtraction is desired, the computer must execute the Clear Decimal 


Mode instruction. 
CLD (CLear Decimal Mode) 


Op code = D8 

Implied Addressing Mode 
One byte long 

Status flags affected - D 


This instruction resets the decimal flag in the Processor Status Register to zero. 
Suppose that we want to add the decimal numbers 18 and 23. We might use 


this program. 


ADD TWO DECIMAL NUMBERS 


300 F8 SED Set decimal mode 

301 18 CLC Clear the carry bit 

302 A9 LDA 23 Load 23 in accumulator 

303 23 

304 69 АРС 18 Add 18 

305 18 

306 20 JSRFDDA Display result as two HEX digits 
307 DA 

308 FD 

309 60 RTS Return to Monitor . 
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To enter the program using the Monitor, type: 


300:F8 18 A9 23 69 18 20 DA FD 60 


following the asterisk prompt. Then execute the program by typing: 300G. 


*300:F8 18 A9 23 69 18 20 DA FD 60 


*300G 


* There's our answer 


The decimal result of 18 + 23 is 41. If we had been adding the hexadeci- 
mal values of 18 and 23, the result would have been 3B. Remember, 18 and 23 
in hexadecimal notation are different values from 18 and 23 in decimal notation. 
Therefore, 41 decimal and 3B HEX are not equivalent values. 

Now let's execute the program starting from location 301 (omitting the 
Set Decimal instruction) and observe the result. 


*300:F8 18 A9 23 69 18 20 DA FD 60 


*300G 
4] — — — First answer 
*301G 


ЗВ «— — — — Second answer 
k 


Once the SED instruction has been executed, all additions in 
the program are performed in the decimal mode. The CLD 
(Clear Decimal Mode) instruction must be used to get back 
to binary addition while the program is running. 


When the computer returned to the Monitor after the first run of the above pro- 
gram, the Monitor automatically executed its own CLD instruction. Therefore, 
when we skipped the SED instruction in the second run, the computer treated 
the two numbers (18 and 23) as hexadecimal values. The result was 3B. The 
SED instruction must be executed in every program if you want to use decimal 
arithmetic. The Monitor will automatically set the decimal bit of the Processor 
Status Register to O (the binary arithmetic mode) when the Monitor is entered. 

The advantage of decimal addition is that it relieves you of converting 
numbers from one base to another for interpretation. You can input decimal 
values (such as 23 and 18) and obtain decimal results. 
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oor x 2 


Try the Add Two Decimal Numbers Program with other pairs of decimal 
values. Substitute them for the values at memory locations 303 and 305. 


Example: 


*303:47 <— Modify first number 
*305:35 «— Modify second number 
*300G ~<~— Run 


82 
* TL Result 


One caution again — make sure that the sum of the two numbers is less than 
100. Any sum whose value is greater than 99 will not fit in the accumulator or 
any memory location. Remember, this is an 8-bit computer. Here is what will 
happen to you if you insist on experimenting (we secretly encourage you). 


*303:84 
*305:29 
*300G 


13 
* ln If my arithmetic is right, that ought to be 113 


Again 


*303:99 


*305:1 

*300G 

00 | -«———- Anyone knows 99 + 1 is 100. It's 
X losing the hundred's place 
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Back to the paper and pencil to see what's happening to our result. 


a4 = 1000 0100 as BCD 
* 19 0010 1001 as BCD 


t 0001 0011 as BCD 

Extra bit Last two digits Decimal add gives 13 
will not in accumulator 

fit are correct 


Since the 6502 microprocessor handles blocks of data in 8-bit sizes, some 
provision must be made for the situation that may result when a sum is larger 
than can be held in 8 bits. This technique was shown in Chap. 8. We will show 
two-byte decimal addition later in this chapter. First let's have a look at decimal 
subtraction. 

We'll use some Monitor Magic to move our addition program to a new 
area of memory so that it will still be available if we need it later. 


Memory 
Address Data 


We'll copy the data 
from 300-309 into 
memory locations 
330-339 


Then we'll alter the original decimal addition program to make it a decimal 
subtraction program. 
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1. Move the program. 
The Monitor must be told the range of the memory block to be moved 


(300 through 309 in our case). It must also be told the beginning memory 
location to which the program is to be moved (330 in our case). The format 
for this command is: 


330; left 300, E 309, “М, for MOVE 
forus pointing for us point for us 


carat 


As seen on the display: 
| PANN 
Destination Start End "MOVE 


To see how it works, first examine the original program. 


*300.309 


0300- F8 18 A9 23 69 18 20 DA | 
0308- FD 60 


*. 


Then make the MOVE. 


* 300.309 


0300- F8 18 A9 23 69 18 20 DA 
0308- FD 60 
*330<300.309M 

V Move it 


xE 


Then, to make sure the move was successful, we can examine both areas of 
memory. 
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*300.309 
0300- F8 18 A9 23 69 18 20DA 
0308- FD 60 

*300«:300.309M 


*330.339 


0330- F8 18 A9 23 69 18 20 DA Examine 330-339 
0338- FD 60 both 
*300.309 alike 


0300- F8 18 A9 23 69 18 20 DA Examine 300-309 
0308- FD 60 


+ 


A simpler way to do this takes advantage of more Monitor Magic. We can 
compare two areas of memory and verify that they are the same by one 
Monitor command called VERIFY. To use the Verify command, the monitor 
also needs to know a range and a destination. The format used is: 


destination<start.end V... 


330^ left- 300^ decimal bad m IT 


carat point 


The Monitor compares the range specified with the range beginning at the 
destination address. If there are any discrepancies, the address where the 
difference is found is displayed along with the two unlike values. If no dif- 
ferences are found, nothing is displayed. 


300<300.309V 


жи ~~ — Nothing displayed, no errors 


Let's modify one location so that we can see how discrepancies are displayed. 


*303:25 ~— 23 changed to 25 for mismatch 
*330«:300.309V 


0303-25 (23) 
at 0333 
Ы | Different values 
at 0303 
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The error should then be corrected (whichever version is wrong) and re- 
verified. 


*303:23 -——— —— Change it 
*330«:300.309V -«— ——— Verify it 


+m «—————— No discrepancy displayed; everything О.К. 


LLS 
87 + + 


ALIKE ? NO 


++ 


| YES 
ALIKE NOW? 


2. Change the original program 


Now we will alter the original program for subtraction. We need to change the 


CLC (18) at location 301 to SEC (38) and ADC (69) at location 304 to SBC 
(E9). 


*301:38 -—— Change 18 to 38 


*304:E9 -«——— ——— Change 69 to E9 


хв 
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Now examine the modified program. 


*301:38 


*304:E9 


* 300.309 

0300- F8 38 A9 23 E9 18 20 DA 
0308- FD 60 

*ш Changes were made 


Now run the subtraction program 


05 


ка M 


23-18 = 5 when working with decimal numbers 


If you need to run the addition program, 


*300G 


05 «——— — 23-18 = 5 
*330G 

41 -«——— —— 23418 = 41 
*щ 


Both programs still exist in memory. You can make the choice as to which 
one is executed. 


300 


Subtract 
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EXAMINING AND ALTERING REGISTERS 


You’ve seen how to examine and alter memory, but how about the regis- 
ters? Can they be examined and changed? Yes, you can do both. 

To examine the registers, hold down the CTRL key. At the same time, 
press the E key. Then release both. Press the RETURN key, and the registers will 
be displayed on the screen. The contents of registers A, X, Y, P, and S will be 
displayed in that order from left to right. Do you remember what the letters 
stand for? 


Accumulator 

Index register X 

Index register Y 
Processor status register 
Stack pointer register 


N VXD 


The values that we see just after turning on the Apple and pressing CTRL 
E together followed by RETURN are: 


-«— ——CTRL E is not displayed 


A=FF X=FF Y=FF P=00 S=FF 


xE 


After you have examined the registers, their contents may be changed (in 
order from left to right) by typing a colon (:) followed by the new values. 
Try these: 


A=FF X=FF Y=FF P=00 S=FF 


*:88 FF 80 33 40 


9 


п Changes 
AX Y PS 


To find out if they have really been changed, press CTRL E to examine 
them again. 


A=FF X=FF Y=FF P200 S=FF -«—— — —— — Originally 
*-88 FF 80 33 40 -——— —— The change 


* -—— CTRL E pressed here 


-88 X=FF Ү=80 P=33 5=40 
A=88 X=FF Y=8 ы. 


*- Changes have been made 
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One of the changes made was to the Processor status register. Its new value 
is 33. Broken down into the individual status bits we now have: 


0011001 1 Processor status register 


Expansion bit Carry bit set 
Is always on 


Break command on Zero result bit on 


Notice that we have set the carry bit. If an addition is performed now, the carry 
bit would be included for the ADC instruction. Let's try it. 


* 
A-88 X-FF Y=80 P233 S=40 
*330:A9 33 69 22 20 DA FD 60 «Program to add 33 


and 22 
*300G  -«—— ——— Run the program 
56 .— — —— — — The carry was included 
*- (33422 + carry = 56) 


Now let's examine the registers again and then turn off the carry bit by 
changing the P register (Processor status register). Then we'll add the two num- 
bers again. 


-— — Examine registers 
A=88 X-FF Y=80 P233 S=40 
*:88 FF 80 32 40 
P register set for 32 


*330G —— Run again 
55 ——————— Result is 55 since carry bit was off 
жщ (33+22+0 = 55) 


This time we'll load 33 into the accumulator, transfer the result to the X 
register, add 22 to the accumulator, and display the result. Then we'll take 
another look at the registers to see how they have changed. 
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The program: 300 A9 LDA 33 
301 33 
302 AA TAX (transfer accumulator to X) 
303 69  ADC22 


304 22 
305 20 JSRFDDA Display result 
306 DA 
307 FD 


308 60 RTS Return to Monitor 


One of the best methods for finding errors in programs is the Monitor's 
Single-Step feature. The Single-Step command decodes, displays, and executes 
one instruction at a time. The instruction is displayed in both machine and 
assembler codes (the Mini-Assembler will be discussed in Chap. 11). 

When the instruction is executed, the contents of the registers are dis- 
played. We'll use the single-step command to watch the registers change as each 
instruction is executed. 

The Single-Step command is an S. To use the command, first type the 
starting address of the program followed by the S. 


Example: 
Machine code 


*3005 


0300- А9 LDA 14$33-———- Assembler code 
А=33 X=FF Ү=80 P230 S=FB —— 
*. Registers 


Address 


For each successive instruction, type an S and press the RETURN key, as 
in the following example. 
Enter the program and then single-step through it. 


*300:A9 33 AA 69 22 20 DA FD 60 


CTRL E to examine 
А ' the registers 
A=88 X=FF Ү=80 P232 S=40 
*300S 


0300- A9 LDA . #$33 


A=33 X=FF Y=80 P=30 S=FB 
S X23 is loaded 
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0302- AA TAX 
A=33 X-33 Y=90 P=30 S-FB 


*S 33 is transferred 
0303- 69 22 ADC #22 
A=55 X=33 Y=80 P=30 S=FB 
*S 
Sum = 55 


0305 20DAFD JSR $FDDA 
A-55 X-33 Y=80 Р=30 S=FB 


*щ Subroutine would display result 


By single-stepping through the program you can see the results of execut- 
ing instructions. Registers affected by each instruction can be seen to change as 
requested. In this example, the Accumulator and the X register were altered as 
the program was executed. 

The subroutine at FDDA contains many, many steps, so we stopped when 
we came to that instruction. І 

You might notice also that the value in the Processor status register was 32 
before the first instruction (LDA) was executed. After execution of the LDA 
instruction, the Processor status register changed to 30. The zero bit has been 
turned off because 33 is not equal to zero. 

Let's now add one instruction, TAY (A8), to transfer the result of the 
addition to the Y register. We won't display the result this time. 


*300:A9 33 AA 69 22 A8 60 
TAY 


* 
и registers (СТВІ. Е) 


Az55 X=33 Y=80 P=30 S-FB 


КЕР FF FF 00 FF 


Set them to original values 
*300S 


0300- А9 33 LDA #33 
А=33 X-FF Y-FF P-30 S-FB 


*S 
33 loaded 
0302 AA TAX 
A=33 X=33 Y=FF P=30 S=FB 
*S 


33 transferred to X 
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ADC #22 


22 added 


TAY 


55 transferred to Y 


0303- 69 22 

A=55 X=33 Y=FF P=30 S=FB 
*S 

0305 A8 

A=55 X233 Y=55 P=30 S-FB 
"5 

0306 60 


*щ 


RTS 
A=55 X233 Y-55 P230 S-FB 


Return to monitor 


So, you see that the X and Y registers can be used for temporary storage. 
In Chap. 11, we'll show how they are used as index registers for instructions 


in the Indexed Addressing modes. 


Let's try one last program to wind up this chapter. This time we'll incre- 
ment the X register, compare it with zero, branching back to increment X again 
if the contents of the X register are not equal to zero. 


300 
301 
302 
303 
304 
305 


The program 


Enter the program 


*.- 


E8 
EO 
00 
DO 
FB 
60 


*300:E8 EO 00 DO FB 60 


INX 5 
CPX 0 4 
3 loop 
BNE FB 2 
1<-FB = -5, check it 
RTS if you wish on the 


Apple (0-5-FB) 


Before we run the program, let's put a value of FD in the X register. How 
long will it be before the contents of the X register reach zero? We'll single-step 


the program to find out. 


* 


*:00 FD 


*щ 


А Х 


*300:E8 EO 00 DO FB 60 


A=55 X=33 Y=55 P230 S=EF 
-«———————— We don’t care about the other registers, so 
we only change the first two, A and X 
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*300:E8 EO 00 DO FB 60 


* 


A=55 X233 Y=55 P=30 S=EF 
*:00 FD 


Next, single-step through the program. 


*300S +——Reauest first step 


0300- E8 INX 
A=00 X=FE Y=55 P=B0 S=F1 
T5 


0301- EO 00 CPX 
A=00 X-FE Y=55 P=B1 S-F1 
*S 


0303- DO FB BNE 
A-00 X-FE Y=55 P=B1 S-F1 
is 


0300- E8 INX 
A=00 X=FF Y=55 P=B1 S=F1 
"5 


0301- ЕО 00 СРХ 
А=00 X-FF Ү=55 Р=В1 S-F1 
*S 


0303- DO FB BNE 
A-00 X-FF Y=55 P=B1 S-F1 
*S 


0300- *8 INX 
A=00 X-00 Y=55 P233 S-F1 
TS 


0301- EO 00 CPX 
A-00 X=00 Y=55 P=33 S-F1 
TS 


0303- DO FB BNE 
A-00 X=00 Y=55 P=33 S-F1 
75 


0305- 60 
A=00 X-00 Y=55 P=33 S-F1 


*. 


<—— X = FD+1=FE 
-—— Next step requested 


#$00 


4—— Next step requested 
$0300 
~<— Next step requested 
—— X=FE+1=FF 
-——— Next step 
#$00 
—+— Next step 
$0300 


-——— — Next step 


— X=FF+1 ie 


Carry bit on due to 
#$00 


-— — Next step 
$0300 


+ Next step 


RTS  ——— ————— Branch was not taken 


since X register = 
CPX value (00) 


SUMMARY 


You have had a tour of the Apple System Monitor in this chapter. You 
have explored some of the features that it has to make machine language pro- 
gramming easier. We hope you will extend these explorations with other experi- 
ments of your own until you are thoroughly familiar with the Monitor's capa- 


bilities. 


You have: 


1. 
2: 


Used hexadecimal addition and subtraction in the Immediate mode, 


Discovered how negative numbers are interpreted using hexadecimal 
values, 


. Learned how to perform addition and subtraction operations with 


binary-coded decimal numbers, 


4. Learned now to move blocks of data from one memory area to another, 


. Learned how to verify that two blocks of memory are the same, and 
. Learned how to examine and alter registers. 


New Instructions 


1. 


2. 


SED (SEt Decimal mode) — used to set the decimal flag in the Proces- 
sor status register to 1. All subsequent add-and-subtract instructions 
are then executed as if the values to be operated on are binary-coded 
decimal numbers. 

CLD (CLear Decimal mode) — resets the decimal flag in the Processor 
status register to 0. This returns addition and subtraction operations 
to binary format. 


. TAY (Transfer Accumulator to Y register) — copies the contents of 


the accumulator into the Y register. 


New Monitor Commands and Uses 


1. 


Hexadecimal add and subtract — type in two 2-digit HEX numbers 
separated by the operation symbol and press RETURN. A 2-digit HEX 
result is displayed. 


. Move a block of data in memory — provide the Monitor with the ad- 


dress range of the block to be moved and the beginning destination 
address. The Monitor will then copy the data into the destination 
area. 

Format: destination start.endM 

Example: *330<300.309M 

—would copy the block of data in memory 


locations 300 through 309 into memory 
locations 330 through 309. 


. Verify two blocks of data — provide the Monitor with the address 


range of one block of data and the starting address of the second 
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block of data. The Monitor will compare the two blocks and let you 
know if a discrepancy exists. 
Format: ^ destination start.endM 
Example: *330<300.309V 
—would compare data in memory 
locations 300 through 309 with 


data in memory locations 330 
through 339. 


4. Examine registers — The A,X,Y,P, and S registers may be examined by 
pressing the CTRL and E keys together followed by a RETURN. 


5. Alter registers — The A,X,Y,P, and S registers may be modified by 
first examining them as in 4 above, then typing a colon followed by 
the new values, in order, separated by one blank space. 


EXERCISES 


1, Using hexadecimal addition in the Immediate mode, provide answers to the 


following: 
a. *2E+35 c. *A4-31 


b. *E5+F * 5A-2E 


2. What would be displayed if the following were executed in the Immediate 
mode? 
a. *D7+4F b. *24-27 


3. Express the following decimal numbers in binary-coded decimal form. 
a. 28- 
b. 37 = 
с. 91 = 


4. If the Add Two Decimal Numbers Program is modified as shown below, fill 
in the displayed result. 


*303:42 


*305:53 


*300G 


-«— fill in answer here 
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. Show how to use the Monitor Move command to move the Add Two Deci- 
mal Numbers Program to memory locations 350 through 359. 


. Show how to verify that the Move of Exercise 5 was made correctly. 


. Describe how to examine the registers. 


RENE UID a A ———ÁÀ——Á— 


PENNE MEUM MMC) AMMOM—COM——'——————————————É—————————À—! 


. Suppose that you had examined the registers, and the display shows the re- 
sults below. Show what would be typed to change the accumulator to 00, the 
X register to 80, and the Y register to 40. 


A-FF X=FF Y=FF P-00 S-FF 


* 


ANSWERS TO EXERCISES 


. a. 763 c. 773 
b. -F4 d. =2C 
. а. 7-26 b. -FD 
(carry is not shown, (FD=-3) 
D7+4F=126) 


. а. 28 = 0010 1000 
b. 37= 0011 0111 
c. 91 = 1001 0001 


4. 95 (42*53-95 in decimal) 


| *350«:300.309M 
| *350«:300.309V 
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7. Press the CTRL and E keys together. 
Then press the RETURN key. 


8. 


A-FF X=FF Y=FF P=00 S=FF 
*:00 80 40 


(the others do not have to be changed) 
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Chapter 11 


Mini-Assembler and 
Addressing Modes 


[МА || sm | 


There is another program that is part of the Apple Integer BASIC ROM, 
but is not available in the Apple II Plus systems. This program is called the Apple 
Mini-Assembler. It is called “mini” because it cannot understand symbolic labels 
that full-sized assemblers can. It is very useful in creating machine language 
programs. 

In past chapters, we have been showing machine language codes along with 
their mnemonic codes. The mnemonic code is an abbreviated name for each in- 
struction. We have been translating these mnemonic codes into hexadecimal or 
binary machine language instructions (Op codes). This process is called hand 
assembly. 


Examples: | 
Mnemonic Addressing Machine 
Code Code Code 
LDA Immediate A9 
ADC Immediate 69 
CLC Implied 18 


Hand assembly is an uninteresting and tedious task that is very prone to 
small, but disastrous, errors. The length of instructions vary, and branch des- 
tinations may be calculated. Some instructions require data as operands, while 
others require memory addresses or registers. It is easy to pick wrong Op codes 
or addresses. It is also easy to transpose or mistype digits, etc. It would be much 
easier for us to assign the job of assembling a program to the computer. The 
Apple Mini-Assembler can easily take care of assembling programs for us if we 
write the programs using assembly language instructions. This chapter will be 
devoted to learning the rules for using the Mini-Assembler and the assembly 
language form for the many addressing modes used. 
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Comparing Assembling Methods 


HAND ASSEMBLE 


Decide on Mnemonic Code 


Look up Machine Code 


СӘ 


Translate Operand from HEX to 
DECIMAL ) 


Assign memory 17) 
Write Op Code and Operand 
| Repeat until done | until done 


Enter program via Monitor 


Run via Monitor 


USING THE MINI-ASSEMBLER 


MINI-ASSEMBLER 


Decide on Mnemonic Code 


Translate Operand from HEX to 
DECIMAL 


ER 250 í Ib 


Type in Computer 


Repeat until done 


Run via Monitor 


In order to use the Mini-Assembler, you must know how to access it, and 
how to get out of it when you have finished assembling your program. If you 
have the Applesoft II ROM card in your Apple, turn the switch on the back of 
the computer to Integer BASIC. The Mini-Assembler program is in this ROM. If 
your machine does not have Integer BASIC, it does not have the Mini-Assembler. 
This chapter would not then be applicable to your system. Other assemblers are 
available that can be entered from tape or disk. 


To run the Mini-Assembler, type: F666G 


*F666G -«—————— You type 


Il 4— ——— —— Assembler responds with its prompt, the 
exclamation point (!) 


Eventually, you'll want to leave the Mini-Assembler and re-enter the Moni- 
tor to run the program that you have assembled. This can be done in either of 
two ways: 

1. Press the RESET key 


2. Type the Monitor Command (preceded by a dollar sign): $FF69G 


! $FF69G -«—— You type 
* — The Monitor prompt appears 
After accessing the Mini-Assembler and before returning to the Monitor, 


an assembly language program is entered. We'll use the Add Two Decimai Num- 
bers Program from Chap. 10 for a brief demonstration. 


*F666G -—— Starting in the Monitor, type this 


Ill -4—— ————— Mini-Assembler prompt appears 
Ready to go 


2. Type in the address of the first instruction, a colon, and the mnemonic 
code for the first instruction. The Mini-Assembler displays each instruc- 
tion as it is assembled. 


*F666G 


1300:SED -«——— You enter address: instruction 


When you press the RETURN key, your assembly instruction disap- 
pears, and the assembled machine language code appears. 
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*F666G 


0300- F8 SED -«——- There it is 
Im 

Mnemonic 
Cursor, ready Op code 
for next Address 
instruction 


3. Type only the mnemonic for Clear carry. 


*F666G 


0300- F8 SED 


! CLC®  «—— Clear carry 


1 blank space 


Press RETURN 


*F666G 


0300- F8 SED 


0301- 18 CLC 
ш «———————— Next? 


Notice the blank space following the Mini-Assembler prompt. If the 
blank space is not placed there, the instruction will not be accepted. 
The Mini-Assembler will show where an error occurs in an improper 
entry. 


Example: 


*F666G 


0300- F8 SED 

{CLC 

^ 

i» ae Up arrow shows where the error is. 


Try again. 
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4. So far, both instructions used have been in the Implied mode and need 
no operand. The next instruction, LDA, is in the Immediate mode, and 
must be followed by the # sign followed by the operand 23 to tell the 
computer that this is an immediate operand. 


*F666G 
0300- F8 SED 


0301- 18 CLC 
ILDA #238  -«— ————— Туре 


Blank space 


Press RETURN 


*F666G 


0300- F8 SED 
0301- 18 CLC 
0302- A923 LDA #$23 


5. Next, the ADC instruction followed by #18. 


! ADC #188 a — ——— Type 


Press RETURN 


*F666G 
0300- F8 SED 
0301- 18 CLC 


0302- A923 LDA #$23 
0304- 69 18 ADC #$18 
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6. Next, the JSR instruction followed by the Absolute address FDDA. 


! JSR FDDA® -««——— — —— Type 


Press RETURN 


*F666G 

0300- F8 SED 
0301- 18 CLC 
0302- A9 23 LDA #$23 
0304- 69 18 ADC #$18 


0306- 20 DA FD JSR $FDDA 
а 


7. Last, the RTS instruction (Implied mode) 


Press RETURN 


*F666G 


0300- F8 SED 

0301- 18 CLC 

0302- A9 23 LDA #$23 
0304- 69 18 ADC #$18 
0306- 20 DA FD JSR $FDDA 
0309- 60 RTS 
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8. Now, leave the Mini-Assembler. The program has been assembled. 


0306- 20 DA FD 


0309- 


Type this to get back to 


ж 


The assembled program is now in memory. You may list it with the Moni- 


tor command L. 


The list command of the Monitor works just like the LIST command of 


60 


BASIC language. If you type: 
300L and press RETURN 


the Monitor lists the contents of 20 consecutive memory locations starting with 


300. 


JSR $FDDA 
RTS 


the Monitor 


*300L <—— List command 


0300- 
0301- 
0302- 
0304- 
0306- 


F8 

18 

A9 23 

69 18 

20 DA FD 


0309- 60 
030A- FF 
030B- FF 
030C- FF 
030D- FF 
030E- FF 
030F- FF 
0310- FF 
0311- FF 
0312- FF 
0313- FF 
0314- FF 
0315- FF 


0316- FF Н 


0317- FF 


* 


SED 
CLC 

LDA #$23 
ADC #$18 
JSR $FDDA 


RTS 
222 


22? All this data is 
222 meaningless to us 
22? and to the 

22? Mini-Assembler 


??? 
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The first few lines are your assembly language program. The rest of the 
lines are not used by the program. Each time the List command is given, 20 
address locations are displayed. For longer programs, 20 more locations will 
be displayed each time that you press the L key and RETURN. 

Now it's time to run the program. 


*300G 


4] 4—— — — Same result as before 
ж 


Notice that when using the Mini-Assembler, we didn't have to look up the 
machine language codes for the instructions. Mnemonic codes are much easier to 
remember than numeric codes. Remember, though, as we mentioned earlier, 
that some instructions can be used in several Addressing modes. How does the 
Mini-Assembler know which mode we want? 

In the Add Two Decimal Numbers Program, the choices to be made by the 
Mini-Assembler were easy. Look at the instructions that were used. 


1. SED (Set decimal mode) — this instruction is only used in the Implied 
mode. No choice necessary. 


2. CLD (Clear carry) — this instruction is also used only in the Implied 
mode. No choice necessary. 

3. LDA (Load accumulator) — Notice the pound sign (#) in front of the 
number 23. That tells the assembler that the code for the Immediate 
Addressing mode is needed. 


4. ADC (Add with carry) — Once again, the # sign is used to denote the 
Immediate Addressing mode. 


dh 


JSR (Jump to subroutine) — this instruction is only used in the Ab- 
solute Addressing mode. No choice necessary. 


You have used the Implied, Immediate, Zero Page, and Absolute Address- 
ing modes frequently. We'll now turn our attention to Indexed Addressing, 
which is quite useful although a little more ш 


INDEXED ADDRESSING 


Two of the most frequently used instructions either load the accumulator 
or store the contents of the accumulator into memory. We'll use these two in- 
structions to demonstrate the Indexed Addressing modes. Here is a list of In- 
dexed modes. 
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LDA 


Assembly Addressing Number of 
Language Form Mode Bytes Used 


LDA oper, X Zero Page, X 


LDA oper, X Absolute, X 
LDA oper, Y Absolute, Y 
LDA(oper, X) | (Indirect, X) 
LDA(oper),Y | (Indirect), Y 


STA 


Number of 
Bytes Used 


Addressing 
Mode 


Assembly 
Language Form 


STA oper, X Zero Page, X 


STA oper, X Absolute, X 
STA oper, Y Absolute, Y 
STA(oper, X) | (Indirect, X) 
STA(oper), Y | (Indirect), Y 


ZERO PAGE INDEXING 


Because zero page instructions execute quicker than other addressing 
modes, the Apple computer already uses most of the necessary locations used by 
these instructions. Zero page memory locations are those from 0000 through 
OOFF. Only the low-order part of the address is necessary for the computer to 
recognize the location required. By looking at the Zero Page Memory Map (pages 
74 and 75 of the Apple 11 Reference Manual), you may notice that 0000 through 
001F are not used by the Monitor or by the Integer BASIC ROM. They are used 
by Applesoft II BASIC. If we stay out of Applesoft Il BASIC, we may be able 
to use that area of memory for demonstrating Zero Page Addressing. 

All instructions that use this mode of addressing except LDX (Load the X 
register) and STX (Store the X register) use the X register to modify the instruc- 
tion's operand (the address used). 


LDA oper, X Load accumulator from the zero 
Op code B5 (Zero page) page address + contents of the 
2nd byte, operand X register 


(low order address) 
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Examples: 
1. Contents of X register = 3 


304 LDA 0,X would load the accumulator from 
the memory address 0003 
(0000 + 03) 
CX 
À 
Zero piss Ое на Contents of 
X register 
2. Contents of X register = 2 
307 LDA 3,X would load the accumulator from 
memory address 0005 
(0003 * 02) 
TAS 
Zero Tao Contents of 
X register 
STA oper, X Load accumulator from the zero 
Op code 95 (zero page) page address + contents of 
2nd byte, operand X register 


(low order address) 


This instruction works just like the LDA oper, X (Zero Page mode) 
except that the accumulator's contents are stored. 


Both types are demonstrated in the following program, which moves the 
values from memory locations 0005 and 0006 to memory locations 0015 and 
0016. We'll use the Mini-Assembler to assemble the program. 


*F666G 


Type: 300:LDX #5 


*F666G 


0300- A205 LDX #$05 . «—-First instruction assembled 
Туре >! ! LDA #22 
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*F666G 


0300- A205 LDX #$05 
0302- A922 LDA #$22 -— Nextinstruction added 
Type >| ! STA 0,X 


*F666G 


0300- A205 LDX #$05 

0302- A922 LDA #$22 

0304- 9500 STA $00,X ~—— Next 
Туре»-| ! LDA #33 


0300- A205 LDX #$05 
0302- A922 LDA #$22 
0304- 9500 STA $00,X 
0306- A933 LDA #$33 ~—Next 


Туре»-| ! STA 1,X 


*F666G 


0300- A205 LDX #$05 
0302- A922 LDA #$22 
0304- 9500 STA $00,X 
0306- A933 LDA #$33 
0308- 9501 STA $01,X 4— Next 


Type>| ! LDAO,X 
One new instruction added each time 


*F666G 


0300- A205 
0302- A922 
0304- 9500 
0306- A933 
0308- 9501 

030A- B500 
! STA 10,X 


LDX #$05 
LDA #$22 
STA $00,X 
LDA #$33 
STA $01,X 
LDA $00,X 
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0300- 
0302- 
0304- 
0306- 
0308- 
030A- 
030C- 
! INX 


*F666G 


*F666G 


A2 05 
A9 22 
95 00 
A9 33 
95 01 
B5 00 
95 10 


0300- A205 
0302- A922 
0304- 9500 
0306- A933 
0308- 9501 
030A- B500 
030C- 9510 
030E- E8 

! LDA 0,X 


F666G - 


0300- A205 
0302- A922 
0304- 9500 
0306- A933 
0308- 9501 
030A- B5 00 
030C- 9510 
030E- E8 

030F- B500 
! STA 10,X 


LDX #$05 
LDA #$22 
STA $00,X 
LDA #$33 
STA $01,X 
LDA $00,X 
STA $10,X 


LDX #$05 
LDA #$22 
STA $00,X 
LDA #$33 
STA $01,X 
LDA $00,X 
STA $10,X 
INX 


LDX #$05 

LDA #$22 

STA $00,X 
LDA #$33 

STA $01,X 
LDA $00,X 
STA $10,X 
INX 

LDA $00,X 
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0300- A205 LDX #$05 
0302- A922 LDA #$22 
0304- 9500 STA $00,X 
0306- А9 33 LDA #$33 
0308- 9501 STA $01,X 
030A- B500 LDA $00,X 
030C- 9510 STA $10,X 
030E- E8 INX — 

030F- В5 00 -LDA $00,X 
0311- 9510 STA $10,X 
! RTS | 


F666G 


0300- A205 LDX #$05 
0302- A922 LDA #$22 
0304- 9500 STA $00,X 
0306- А9 33 LDA #$33 
0308- 9501 STA $01,X 
030A- В5 00 LDA $00,X 
030C- 9510 STA $10,X 
030E- E8 МХ 
030F- В5 00 LDA $00,X 
0311- 9510 STA $10,X 
0313- 60 RIS —— 


! $FF69G a hee tur | 
| Leave the Mini-Assembler 


* 


Zero Page Indexed instructions were used at 0304, 0308, 030A, 030C, 
030F, and 0311. Now run the program. Then examine locations 0005, 0006, 
0015, and 0016. 


*300G 


*0005.0006 


0005- 22 33 4————— Original 
*0015.0016 . 


0015- 22 33 «Copy 


Ж 
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ABSOLUTE INDEXED ADDRESSING 


Either the X or the Y index register can be used to index an absolute ad- 
dress in this mode. You do not have to restrict yourself to zero page memory. 


Examples: 
LDA 310,X 
Op code BD (Absolute indexed) 
2nd byte, low-order address (10) 
3rd byte, high-order address (03) 


This instruction loads the accumulator from the memory address 0310 4 
contents of the X register. (Y could also be used.) 


STA 320, Y 
Op code 99 (Absolute indexed) 
2nd byte, low-order address (20) 
3rd byte, high-order address (03) 


This instruction stores the contents of the accumulator into memory 
address 0320 * contents of the Y register. (X could also be used.) 


We'll use these instructions to store some characters from the keyboard 
into memory and to retrieve them for display on the video screen. We'll use the 
Mini-Assembler to put the program together. 

First we'll store 17 characters from the keyboard in a consecutive memory 
block using the STA Indexed Addressing mode with X as the index register. 


*F666G 


1300:LDX #0 -— Load X with zero 


*F666G 


0300- A200 LDX #$00 
! JSR FD35 —— Get a character 


*F666G 


0300- A200 LDX #$00 
0302- 2035FD JSR $FD35 | 
! STA 1000,X -———- Store it 


240 


0300- 
0302- 
0305- 
! INX 


*F666G 


*F666G 


*F666G 


A2 00 
20 35 FD 
9D 00 10 


0300- A200 
0302- 20 35 FD 
0305- 9D 0010 
0308- ES8 

! CPX #11 


0300- A200 
0302- 20 35 FD 
0305- 9D0010 
0308- ES8 
0309- E011 

! BNE 302 


LDX #$00 

JSR $FD35 

STA $1000,X 
-——— Increase X by one 


LDX #$00 
JSR $FD35 
STA $1000,X 
INX 
-—— Done yet? 


LDX #$00 
JSR $FD35 
STA $1000,X 
INX 

CPX #$11 


«<— If not, go back to 302 


LDX #$00 
JSR $FD35 
STA $1000,X 
INX 
CPX #$11 
BNE $0302 
-«——— Clear the screen 


*F666G 

0300- A200 
0302- 2035FD 
0305- 9D 0010 
0308- E8 
0309- E011 
030B- ООЕ5 

! JSR FC58 
*F666G 

0300- A2 00 
0302- 20 35 FD 
0305- 9D 0010 
0308- E8 

0309- E011 
030B- DOFS 
030D- 20 58 FC 


LDX #$00 
JSR $FD35 
STA $1000,X 
INX 

CPX #$11 
BNE $0302 
JSR $FC58 
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Let's pause here to see how this part of the program works. Notice that 
this part contains a loop that is much like a BASIC FOR-NEXT loop. The sub- 
routine at FD35 waits for a character to be typed from the keyboard. The char- 
acter is then stored by the Absolute Indexed instruction (STA 1000,X). The X 
register is increased by one and tested to see if it has reached 11 (HEX). If 
not, a loop is made back to the subroutine for another character. Wnen the 
seventeenth character has been typed, X will have reached 11. The screen is 
then cleared by the subroutine at FC58. Not only does the X value control the 
exit from the loop; it also indexes the memory address at which the character 
is stored. Thus, the characters are stored in consecutive memory locations like 
this. 


Pass Through Memory Used to Store 
the Loop Character 


Continuing on with the second part of the program, input the following 
instructions each time you see the Mini-Assembler prompt: 


! LDX #0 Reset X to zero 

! LDA 1000,X Load a character from memory 
! JSR FDED Display it 

! INX Get ready for the next one 

! CPX #11 Done yet? 

! BNE 312 If not, go back to 312 

! RTS If done, go to Monitor 


After this, the display will show: 
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*F666G 


0300- A200 LDX #$00 

0302- 2035FD JSR $FD35 

0305- 90 0010 STA $1000,X First part 
0308- E8 INX 

0309- E011 CPX #$11 

030B- DOFS BNE $0302 

030D- 20 58 FC JSR $FC58 

0310- A200 LDX #$00 

0312- BD 0010 LDA $1000,X 

0315- 20ED FD JSR $FDED Second part 
0318- E8 INX 

0319- E011 CPX #$11 

031B- ООЕ5 BNE $0312 

031D- 60 RTS 


I$FF69G -— End it by leaving the 


Mini-Assembler 
* 


The second part of the program also contains a loop that loads a charac- 
ter from memory and displays it. The loop continues until all 17 characters 
have been displayed. It then returns to the Monitor. The Indexed Addressing 
instruction (LDA 1000,X) is used to load the accumulator on each pass through 
the loop. Since the X register was reset to zero at the start of the loop, the 
instruction retrieves the previously stored characters in the same order that they 
were stored (see table shown earlier in this chapter). Indexed addressing is very 
handy to load and store values in blocks of consecutive memory locations. 

When you run the program, type in 17 characters from the keyboard 
(count spaces as characters). You won't see the characters as they are typed in. 
They will be displayed after you have entered all 17. Here is a typical run with 
the message "ABSOLUTE INDEXING." You may use any 17 character mes- 
sage. Or make a few alterations to the program and fill the screen. 


031D- 60 RTS 


I$FF69G 
*300G -—— ———— ————- Nothing more is displayed until 
ш | you have finished typing in your 


message. When it is finished: 


| ABSOLUTE " cd 
* 
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The Y register could have been used instead of the X register for indexing. 
Either may be used. Е 


STA 1000,Х ог STA 1000,Ү 
LDA 1000,Х ог LDA 1000,Y 


You could also use a combination of the two: 


STA 1000,X 
LDA 1000,Y 


Of course, the proper register must be given the correct initial value and incre- 
mented. 


INDEXED INDIRECT ADDRESSING 


The major use of this mode is in picking up data from a table or list of 
addresses to perform an operation. | 

Since there is not much unused space in our zero page memory, we can 
only present a trivial demonstration of this addressing mode. Once again, the 
LDA instruction will be used as an example. 

The format is: 


LDA (oper,X) 
Op code A1 
2nd byte, offset 


The second byte of the instruction (the offset) is added to the contents of 
the X register (any carry is dropped). The result points to a /ocation in zero page 
that contains the low order part of the effective address from which the data is 
loaded. The next zero page location holds the high-order part of the effective 
address. 


Example: 


Memory location 0019 contains the value 45 
Memory location 001A contains the value 10 
The X register contains the value 14 
The instruction to be executed is: 

LDA (05,X) 


First, the value in the X register is added to the operand (offset) 14 + 5 = 
19. The result is the zero page address that contains the low-order address 
of the memory location from which the accumulator will be loaded. 
Second, the high-order address of the memory from which the data will 
be loaded is found in the next zero page address (19+1=1A). 
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In the example: 


Operand 
+ 
X reg. 


Zero | 
page 
location 


10 45 Data pointer 


10 


High order 
45 
Low order 


After LDA (05,X) is executed: Accumulator 


Now let's try a short demonstration of the Indexed Indirect Addressing 
mode for the LDA instruction using the Mini-Assembler to assemble the pro- 
gram. First, type in the instructions after the ! prompt. Each line is assembled 
as you make your entries, but we will not show the display until all entries have 


been made. 
1300:LDX #14 Put 14 in the X register 
! LDA #10 | Put 10 in accumulator 
! STA 1A Store it in 001A 
! LDA #45 Put 45 in accumulator 
! STA 19 Store it in 0019 
! LDA #33 Put 33 in accumulator 
! STA 1045 Store 33 in 1045 
! LDA #0 Put in zero 
! LDA (05,X) Indexed Indirect Addressing mode 
! JSR FDDA Display accumulator 
! RTS 

The display: 
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*F666G 


0300- A214 LDX #$14 
0302- A910 LDA #$10 
0304- 851A STA $1A 
0306- A945 LDA #$45 
0308- 8519 STA $19 
030A- A933 LDA #$33 
030C- 8D 45 10 STA $1045 
030F- A900 LDA #$00 
0311- A105 LDA ($05,X) 
0313- 20DA FD JSR $FDDA 
0316- 60 RTS 


I$FF69G — ~ec Leave the Mini-Assembler 


* 


Run the program. The accumulator is loaded by the Indexed Indirect Ad- 
dressing mode instruction at 0311. Then the value 33 is displayed. 


0313- 20DAFD JSR $FDDA 
0316- 60 RTS 
I$FF69G 

*300G 


* There it is! 


We can see that 33 has been displayed as we expected. How do we know 
that it was really displayed because of the Indexed Indirect Addressing instruc- 
tion at location 0311? 

If you want to watch each step, single-step through the program until you 
reach the jump to subroutine instruction at 0313. At that point the 33 should 
have been moved into the accumulator by the Indexed Indirect Addressing 
instruction, LDA (05,X). 
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*3005 


0300- А2 14 LDX #$14 

A=00 X214 Y=FF P=30 S-0C 
*S 
0302- A910 LDA #$10 

A=10 X=14 Y=FF P=30 S=0C 
*S 
0304- 851A STA $1A 

A=10 X214 Y=FF P=30 S=0C 
*S 
0306- A945 LDA #$45 

A=45 X=14 Y=FF P=30 S=0C 
*S 
0308- 8519 | STA $19 

A245 X214 Y-FF P=30 S=0C 
*S 
030A- A933 LDA #$33 ? 

A-33 X=14 Y-FF P230 S=0C 
*S 
030C- 8D4510 . STA $1045 

A=33 X214 Y=FF P230 S=0C 

*g | | 

| This was done to make 
030F- A900 LDA #$00 ~—— sure the accumulator 
A=00 X=14 Y=FF P=30 S=0C was Cleared of the 33 
*S 
0311- А1 05 LDA ($05,X) x | Ї 
Accumulator loaded 


A=33 X=14 Y=FF P=30 S-0C 

*S b ME RN DIRE by Indexed Indirect 
Addressing 

0313- 20DAFD JSR $FDDA 

A=33 X=14 Y-FF P=30 5=0С © 


* A c 2 ш. 
| Stop here 


That last program wasn't very interesting, was it? This time let's use In- 
dexed Indirect Addressing to access two different lists of data. The first list 
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will consist of color values, and the second will contain rows at which lines will 
be plotted. . 

We'll use the Mini-Assembler to enter the program and the Monitor to 
enter the data lists. 

Start with the Mini-Assembler. 


*F666G 


1300:JSR FC58m -«——— Starting address, colon, and 1st instruction 


Press the RETURN key 


*F666G 
0300- 20 58 ЕС JSR $FC58 
! JSR FB40m ж—————— 2nd instruction 


Don't forget the space 


*F666G 


0300- 20 58 ЕС JSR $FC58 
0303- 2040FB JSR $FB40 
! LDA #408 3rd instruction 


Continue in the same manner until all of the following instructions have 
been entered. 


The complete instruction list. 


*F666G 


1300:JSR ЕС58 
! JSR FB40 
! LDA #40 


! STA 10 Set up the Indexed Pointers 
! LDA #50 a 
! STA 12 | 


! LDA #10 
! STA 11 
! STA 13 
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4 LDY #5 -——————- Starting point for line 


! LDA #20 
! STA 2C | “End point for line 
! LDX #0 
! LDA (10,X) мане Set color 
! STA 30 
! LDX #2 
LOOP| ! LDA (10,X) ]— — set row | 
! JSR F819 — Draw the line 
! INC 10 Increase pointer values 
! INC 12 pee—— | 
! LDA 10 See if done 
! СМР #47 uiii 
! BNE 314 
! RTS 


When you have entered all the instructions, the screen will look like this: 


*F666G 


0300- 20 58 ЕС JSR $FC58 
0303- 2040FB JSR $FB40 
0306- A940 LDA #$40 
3008- 8510 STA $10 
030A- A950 LDA #$50 
030C- 8512 STA $12 
030E- A910 LDA #$10 
0310- 8511 STA $11 
0312- 8513 STA $13 
0314- A005 LDY #$05 
0316- A920 LDA #$20 
0318- 852C STA $2C 
031A- A200 LDX #$00 
031C- A110 LDA ($10,X) 
031E- 8530 STA $30 
0320- A202 LDX #$02 
0322- A110 LDA ($10,X) 
0324- 20 19 ЕЗ JSR $F819 
0327- E610 INC $10 
0329- E612 INC $12 
032B- A510 LDA $10 
032D- C947 CMP #$47 
032F- DOE3 BNE $0314 
0331- 60 RTS 
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To enter the data, return to the Monitor. If you try to enter the data lists 
from the assembler, it will try to interpret the data as instructions. That would 
foul everything up. 


0331- 60 RTS 
I$FF69G 


*1040:FF 11 99 66 CC 33 DD ~—— colors 
*1050:05 07 09 0B ОЮ ОЕ 11 ~——— rows 


*ш 


Now you сап run the program. 


*300G 


The screen is cleared, and 7 colored lines are picked out of the data lists 
and displayed on the screen. 


Here is how the values are picked out to draw the lines. 
Memory Pointer 


If Х=0 — 0010 40 These values are incremented 1 at a 
0011 10 time through the loop to point to 


the locations for color and row. 
If X-2 —- 0012 50 | 


0013 10 
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Color 1040 FF 
| 1041 11 
1042 99 

etc. 
Row 1050 05 
| 1051 07 
1052 09 

etc. 


INDIRECT INDEXED ADDRESSING 


This mode differs in its operation from Indexed Indirect Addressing, al- 
though their names are so similar as to be confusing. 


This mode uses the Y register as an index. We'll use the STA instruction to illus- 
trate how it works. 
The format is: 


STA (oper), Y 
Op code 91 
2nd byte, zero page address 


The second byte of the instruction is a zero page memory address that 
contains a base address. The value of the Y register is added to this base address 
to form the actual low-order part of the address where the contents of the 
accumulator are to be stored. The zero page following that given in the second 
byte provides the high-order part of the storage address. 


Example: 
Accumulator contains the value 55 
Memory location 01 contains the value 32 
Memory location 02 contains the value 11 
The Y register contains the value 7 
The instruction to be executed is: 

STA (01), Y 
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First, the value 32 is obtained from location 0001. 

Second, the contents of the Y register (7) are added. This value (3247-39) 
is the low-order part of the storage address. 

Third, the value 11 from location 0002 is used as the high-order part of 
the storage address. 


Thus, the contents of the accumulator will be stored in memory location 
1139. 


In the example: 


Accumulator [55| 


The instruction STA (01),Y is executed: 


Memory Contents 


Accumulator's 
contents go 


here 
11 39 
— A 
From giga T 3247239 
STA (01), Y 
Y register 


A short demonstration program utilizing the STA (oper), Y instruction 
follows. Once again we show the entries first. 


*F666G 

1300:LDY #7 Load 7 into Y register 

! LDA #32 Load accumulator with 32 

! STA 1 Store in 0001 

! LDA #11 Load 11 

! STA2 Store in 0002 

! LDA #55 Load 55 | 

! STA (01), Y Indirect Indexed Addressing Mode 
! RTS 
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The display after entering instructions: 


0300- 
0302- 
0304- 
0306- 
0308- 
030A- 
030C- 
030E- 


* 


*F666G 


А0 07 
A9 32 
85 01 
A9 11 


8502 


A9 55 
91 01 
60 


LDY #$07 
LDA #$32 
STA $01 
LDA #$11 
STA $02 
LDA #$55 
STA ($01),Y 
RTS 


I$ FF69G 
iig ERN Once again type this in to 


leave Mini-Assembler 


Run the program. Nothing will be displayed. When the prompt shows at 
the end of the program, examine memory location 1139. 


I$FF69G 


*300G 


*1139 «—— — — —— —— Examine memory 


1139- 55 4—— ———— —— Sure enough, there it is 


* 


Refer back to the Automated Scale program in Chap. 6. We'll modify that 
program to provide some changing durations for the notes. The durations and 
pitch values will be obtained from two data lists. They will be accessed by Indi- 


rect Indexed instructions. 
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*F666G 


0300- 
0303- 
0305- 
0307- 
0309- 
030B- 
030D- 
030E- 
030F- 
0310- 
0312- 
0314- 
0317- 
0318- 
031A- 
031C- 
031E- 
031F- 
0321- 
0323- 
0326- 
0327- 
0328- 
032B- 
032C- 
I$FF69G 


MODIFIED AUTOMATED SCALE PROGRAM 


20 58 FC 
AO 00 

B1 03 
85 01 

B1 05 
85 00 
C8 

98 

48 

CO 09 
FO 17 
AD 30 CO 
88 

DO 04 
C6 01 

FO 08 
CA 

DO F6 
A6 00 
4C 14 03 
68 

A8 

4C 05 03 
68 

60 


JSR $FC58 
LDY #0 
LDA (03),Y 
STA $01 
LDA (05),Y 
STA $00 
INY 

TYA 

PHA 

CPY #09 
BEQ $032B 
LDA $C030 
DEY 

BNE $031E 
DEC $01 
BEQ $0326 
DEX 

BNE $0317 
LDX $00 
JMP $0314 
PLA 

TAY 

JMP $0305 
PLA 

RTS 


*1040:FF C8 80 40 C8 40 80 FF 
*1050:85 7F 79 74 6F 6B 67 64 
*03:40 10 50 10 


* 


Load duration from table 
Store it 

Load pitch from table 
Store it 


Save Y value 
See if done 


If so goto end 


The tweak speaker 
part of the program 


Get saved Y value back 
Get another note 

Go back to Monitor 
Duration 

Pitch 


Pointers for Indirect 
Indexed Addressing 


At the start of the program the values in memory used by the Indirect 


Memory 


Indexed Addressing are: 


03-40 
04-10 


Memory 
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05-50 
06-10 


The Y value is added to each of the low-order parts of the addresses (40 at 0003 
and 50 at 0005) to find the correct values of duration and pitch for the notes 
that are to be played. Since the Y value is incremented each time through the 
loop, a new pitch and duration are played each time. 


By changing any of these memory locations, you can vary the pitch and 
duration. With a little imagination, you can extend these data lists to play a 
complete song with notes of varying lengths. If you do, don't forget to re- 
place the CPY value in memory location 0311 to reflect the number of notes 
you wish to play. 

When you run the program, the automated scale will be played. How- 
ever, the length of the notes varies. 


SUMMARY 


Congratulations You are now an assembly language programmer. You 
have had an introduction to the Apple Mini-Assembler and have explored some 
of its uses. You can now program in BASIC, 6502 machine language, and assem- 
bly language. 

We hope you will spend some additional time using the Mini-Assembler. 
Go back through some of the machine language programs that appeared earlier 
in the book and enter them by means of the assembler. Try some of your own 
programs. The more you use assembly language programming, the better you 
will become and the easier it will be. 
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In this chapter you have learned how to: 


. Get back and forth between the Mini-Assembler and the System Monitor 
. Use the mnemonic codes of machine language instructions with the Mini- 


Assembler 


. Enter assembler instructions 
. Use 4 Indexed Addressing modes: 


. Zero Page Indexed 
. Absolute Indexed 
. Indexed Indirect 

. Indirect Indexed. 


№ 


co c 


New Instructions 


1. 


LDA oper,X — Zero Page Indexed load accumulator — loads the accumulator 
from the operand’s zero page address + the contents of the X register 


. STA oper,X — Zero Page Indexed store accumulator — stores the accumula- 


tor’s value into the operand’s zero page address + the contents of the X 
register 


. LDA oper,X — Absolute Indexed load accumulator — loads the accumulator 


from the operand’s full address + the contents of the X register (Y can also 
be used) 


. STA oper,X — Absolute Indexed store accumulator — stores the accumula- 


tor’s value into the operand’s full address + the contents of the X register 
(Y can also be used) 


. LDA (oper,X) — Indexed Indirect load accumulator — loads the accumulator 


from a memory location that is indirectly addressed by the operand’s offset 
+ the contents of the X register. The result “points to” zero page locations 
containing the effective address 


. STA (oper), Y — Indirect Indexed store accumulator — stores the value in the 


accumulator into a memory location that is obtained from the operand's 
zero page memory (and zero page *1). The contents of the Y register are 
added to obtain the low-order part of the effective address. Zero page + 1 
contains the upper part of the effective address. 


. LDA (oper), Y — Indirect Indexed load accumulator — loads the accumula- 


tor from a memory location that is obtained from the operand's zero page 
memory (and zero page *1). The value in the Y register is added to obtain 
the low-order part of the effective address. Zero page + 1 contains the high- 
order part of the effective address. 


. Mini-Assembler Symbols and Commands 


k 
2. 
3: 


F666G — їо enter the Mini-Assembler from the Monitor 
$FF69G — to return to the Monitor from the Mini-Assembler 
! — the Mini-Assembler prompt 
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EXERCISES 


. What is the four-digit hexadecimal command for entering the Mini-Assembler? 
ia G 
. What is the Mini-Assembler's prompt symbol? 


. What is the command to leave the Mini-Assembler and return to the System 
Monitor? 


. The following program has been entered by the Mini-Assembler. Complete 
the display to show a run. | 


*F666G 

0300- F8 SED 

0301- 18 CLC 

0302- A9 17 LDA #$17 
0304- 69 78 ADC #$78 
0306- 20 DA FD JSR $FDDA 
0309 60 RTS 
I$FF69G 

* 


IMMER Y our answers here 


. A program contains the following two instructions. Explain the result of 
their execution. Assume that the X register contains 08. 

Memory Opcode Assembler code 

0302 A9 22 LDA #$22 

0304 95 03 STA $03,X 


END MM. n 


АА M 


. Tell what kind of addressing mode would be used for the following: 
a. STA $03,X 
b. STA $1033,Y 
c. LDA (05,X) 
d. STA (07),Y 


. How many bytes are used for each of the following types of addressing 
instructions? 

a. Absolute Indexed 
b. Zero Page Indexed 
c. Indexed Indirect 
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10. 


10. 


AWN > 


. The program on page 240-44 allowed you to input 17 characters from the 


keyboard. Tell which locations must be changed and what the changes 
would be in order for the program to accept 64 characters. 
Memory Change to 


. Suppose the X register contains 9, the Y register contains 8, and the follow- 


ing values are in the given memory locations: 
. Memory Contents 


0012 | 10 
. 0013 11 
0014 12 


The instruction is executed: LDA (04,X) 
From what memory location would the accumulator be loaded? 


Suppose the same conditions exist as in Exercise 9. 
This instruction is executed: STA (12), Y 
Into what location would the accumulator's contents be stored? 


ANSWERS TO EXERCISES 


"E666G 
| 


.I$FF69G 


. The value 22 would be loaded into the accumulator and then stored in 


memory location 000B. (0003+0008=000B) 


. à. Zero page Indexed c. Indexed Indirect 
b. Absolute Indexed d. Indirect Indexed 
‚а. 3 b. 2 G 2. s 
Memory Change to 


a. 030A 40 (40 HEX = 64 decimal) 
b. 031A 40 


. 1211 Xregister=9 Plus operand=4 gives 13 


high-order address obtained from 0014 = 12 > 


1118 10 from location 0012 (operand) 
* fe from Y register 


18 = low-order address- | 
11 from location (0012+1) = high-order address 


258 


Chapter 12 


Putting It All Together 


You have learned four methods of entering and executing machine lan- 
guage programs in this book. 


1. Directly from BASIC using POKE, CALL, and PEEK 
2. By the BASIC Operating System 

3. Directly in machine language using the System Monitor 
4. By the Mini-Assembler 


We'll use each of the four methods to enter and execute an 8-bit multiplication 
problem in this last chapter. 

The 6502 instruction set does not contain an instruction for multiplication 
or division. However, there are many ways that these two operations can be pro- 
grammed. We will show one that is simple and straightforward. 


8-BIT MULTIPLICATION 


Remember, the computer does its arithmetic using binary numbers. Let's 
first look at a pencil-and-paper example of binary multiplication. We'll multiply 
18 (decimal) by 58 (decimal) using both decimal and binary multiplication. 
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Decimal Binary 


18 — — —Multiplicand ————> 0001 0010 
X 58 -«———— Multiplier ——— X 0011 1010 
144 0000 0000 
90 0 0010010 
Peta 00 0000 00 
ее | | 000 1001 0 
0001 0010 
0 0010 010 
00 0000 00 
Product 000 0000 0 
ln 000 0100 0001 0100 
\ 4 (decimal) 
16 (decimal) 


IT CHECKS ! 7 1024 (decimal) 

1044 (decimal) 

Notice that our multiplication involves adding the multiplicand every 

time a 1 appears in the multiplier. Of course, there is a shift to the /eft each 

time a bit of the multiplier is used, just as there is in decimal multiplication. 
We also proceed from right to left as we “use up” the bits of the multiplier. 

The program we will use does much the same thing. The first part of the 


program will initialize the memories with the appropriate values. We will store 
these quantities in memory as follows: 


Most Significant Byte 
of product 
1001 Least Significant Byte 
of product 
1002 Multiplicand 
(12) 
1003 Multiplier 
(3A) 


The accumulator will temporarily hold the Least Significant Byte of the 
product as the program is executed. You may notice that the multiplier is used 
from left to right (the opposite of the paper-and-pencil method) to simplify 
the process. 
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olof оо 


РА X 
Used first Used last 


The multiplier is shifted left as it multiplies. 


A flowchart is shown to clarify the program. 


ENTER 


Housekeeping 


Load X with 8 
Load memory 1002 with 12 
Load memory 1003 with 3A 


Load accumulator with zero 
Store zero in memory 1000 
Store zero in memory 1001 


Loop 8 Times 


Shift accumulator left 
Rotate MSB of product left 
Shift Multiplier left 


Clear carry 
Add Multiplicand 


No 


Yes 


increment MSB of product | 
Decrement the X register 


" 


Yes 


Store accumulator in 1001 
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The housekeeping chores at the beginning of the program are easy for us 
now. You have used each instruction in this section of the program before. 
They are all either load or store instructions in various addressing modes. 

The following table shows the values to be entered in both decimal and 
hexadecimal forms. 


Assembler 
Mnemonic 


LDX #08 


LDA #12 


STA $1002 


LDA #3A 


STA $1003 


LDA #00 


STA $1000 


STA $1001 


The loop section performs the multiplication. Two new instructions ap- 
pear. One of them, ASL (Arithmetic Shift Left), was discussed in Chap. 3. This 
time we use it to shift the contents of the accumulator at 788 (decimal). We 
also use it in the Absolute Addressing mode at 792 (decimal). When used in 
this mode, the bits of the specified memory are shifted left. 


Example: 
Memory 1003 before ASL $1003 


To carry 
bit of 
Processor 
Status 
Register 


Memory 1003 after ASL $1003 
262 


We will make use of the fact that the Most Significant Bit from the shift is 
moved to the carry bit of the Processor Status Register. 

Another new instruction ROL (ROtate one bit Left) is used at 789 (deci- 
mal) in the Absolute Addressing mode. This instruction is similar to ASL but 
different in one important way. 


Example: | 
| Memory 1000 before ROL $1000 — 


To the carry 
bit of the 
Processor 
Status 
Register 


X is either O or 1 
depending on the 
carry bit when the 
instruction is . 
executed 


Memory 1000 after ROL $1000 


Old carry bit 


As each instruction is executed, the Most Significant Bit moves into the carry 
bit of the Processor Status Register. In the ASL instruction, the Least Significant 
Bit is filled with a zero. In the ROL instruction, the Least Significant bit is 
filled from the carry bit of the status register (either a 1 oraQ). . 

The instructions derive their names from the action that takes place. 


ASL ROL 


C}|76543210}0 
| ‘POUR 


The Arithmetic Shift Left instruction merely shifts each bit to the left one 
place. A zero is shifted into the low-order bit, and the high-order bit shifts into 
the carry bit. The old carry bit is lost. Eo 

The ROtate Left instruction is like a circle. Each bit moves one place 
around the circle (like Musical Chairs). Hence, the bits are rotated one position 
to the left. | 


If you rotate left nine times, everything will be right back where it started. If 
you shift left nine times, you will have zeros in every bit (including the carry 
bit). 

The following table shows both decimal and hexadecimal values to be 
entered for the loop and exit from the program. 


= [= [= | 
ASL А 


46 ROL $1000 
0 
16 
14 ASL $1003 
3 
16 


Assembler 
Mnemonic 


ешю GED Qum Gen QUO UP UNA, c — an an Qum Qu) ap UD nan oe ts er (um pm no (UR pme ap am om m ото UND CUP Ao a WEM QUUD QUO QUO GRE ONO CED Gua OND EN D eee (emm be SE D Бан FEES ү 


BNE $0314 


STA $1001 
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MULTIPLICATION DIRECTLY FROM BASIC 


The machine language program can be directly POKEd into memory from 
BASIC. A FOR-NEXT loop filled with READ and POKE statements will accom- 
plish this. The program is then executed by a CALL statement, and a PRINT 
PEEK statement is used to display the result. Be sure you are in the Applesoft 
П BASIC mode. 


MULTIPLICATION FROM BASIC 


10 FOR M = 768 TO 812 

20 READ D 

30 POKE M,D 

40 NEXT M 

50 CALL 768 

60 PRINT PEEK(4096)*256+PEEK(4097) 
70 END 

80 DATA 162,8,169,18,141,2,16,169,58,141 
90 DATA 3,16,169,0,141,0,16,141,1,16 

100 DATA 10,46,0,16,14,3,16,144,9,24,109 
110 DATA 2,16,144,3,238,0,16,202,208 
120 DATA 235,141,1,16,96 


After the program has been entered, type RUN to execute it. The follow- 
ing is displayed. 


] RUN 
1044  4«— —— Тһе result is displayed 


]= 


Entering the program directly from BASIC has the advantage of speed of 
entry. A simple FOR-NEXT loop POKEs all the machine language codes into 
their proper places. The program is then executed by one CALL statement, and 
the result is displayed by PRINT PEEK. 

However, there are disadvantages. Each instruction and address referenced 
in the program must be converted from hexadecimal notation to its decimal 
equivalent before the program can be entered. Remember, machine language 
references are in hexadecimal code, and BASIC uses decimal numbers. The con- 
version can be time-consuming if the program is long. The process is subject to 
many human errors. Though seemingly small, these errors can prove disastrous 
to a program in execution. If mistakes are made, there is no way of debugging 
the program directly, since you are not using the Apple System Monitor when 
you are in BASIC. 
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MULTIPLICATION USING THE BASIC OPERATING SYSTEM 


When using the BASIC Operating System, the addresses are entered by 
the system (except for the starting address). The machine language Op codes are 
entered in hexadecimal form directly from the reference manual. 

The Operating System must be loaded from tape or entered from the 
keyboard (See Chap. 2). When RUN, the program requests the starting address 
and the number of bytes, Our starting address is 768, and there are 45 bytes. 


STARTING ADDRESS FOR M/L=?768 
HOW MANY BYTES?45 

PRESS RETURN TO ENTER PROGRAM 
768 m 


Now enter the program. The computer will keep track and print each 
memory location in order. All you have to do is type in the correct hexadecimal 
code. (See tables shown earlier in chapter for the hexadecimal Op codes to be 
entered.) After the program has been completely entered, the Operating Sys- 
tem displays your entries in blocks of 20 bytes, as follows. 


HERE IS YOUR PROGRAM 


768 A2 
769 08 
770 A9 
771 12 
772 8D 
773 02 
774 10 
775 A9 
776 3A 
777 8D 
778 03 
779 10 
780 A9 
781 00 
782 8D 
783 00 
784 10 
785 8D 
786 01 
787 10 
PRESS ANY KEY TO CONTINUE 


266 


You should then check over this partial listing for any errors. Make a note 
of the corrections to be made, but do not make the corrections until asked for 


at the end of the final display block. You are now ready to look at the next 
block of 20 (or fewer) data bytes. 


PRESS ANY KEY TO CONTINUE 


Now the last block of data. 


808 EB 
809 8D 
810 01 
811 10 
812 60 
PRESS ANY KEY TO CONTINUE 


Now when you press any key, you get a chance to make your changes. 


IF ANY CHANGES-TYPE ADDRESS 
IF NOT — TYPE 99 


?m 
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If no changes, type 99 and press any key to RUN. 


IF ANY CHANGES- TYPE ADDRESS 
IF NOT — TYPE 99 

?99 

PRESS ANY KEY TO КОМа 


When the program has stopped, type: 
PRINT PEEK(4096)*256+Peek(4097) 


] PRINT PEEK(4096)*256*PEEK (4097) 
1044 


]= 


This method overcomes the disadvantage of having to convert the hexa- 
decimal codes to decimal values for BASIC. The Operating System does this 
for us. All the user has to do is to type in the starting address, the number of 
bytes, and each hexadecimal data byte. 

Of course, we must go to the trouble of loading the BASIC Operating 
System each time we want to use it. If you have a disk system, this is no big 
problem. Loading from a cassette recorder is slower, and entering from the 
keyboard is the slowest of all. The BASIC Operating System is rather cumber- 
some to use, but it has served the purpose of introducing you to machine lan- 
guage programming in nice, easy steps through BASIC commands and state- 
ments. 


MULTIPLICATION USING THE SYSTEM MONITOR 


This is the most direct way to enter a machine language program. All 
you have to do is type in the starting address and each hexadecimal value separ- 
ated by a blank space. Long programs should be broken up into sections of 
approximately 3 physical line lengths. This time we will use hexadecimal data. 


*300:A2 08 A9 12 8D 02 10 A9 3A 8D 03 10 
A9 00 8D 00 10 8D 01 10 OA 2E 00 10 OE 
03 10 90 09 18 6D 02 10 90 03 EE 00 10C 
A DO EB 8D 01 10 60 


* 
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To run the program, you merely type in: 


To see results, type: 


*300G 


*1000.1001 
1000- 04 14 
T 0414 HEX =4 X 256 = 1024 decimal 
* 1X 16-2» 16 decimal 
4X 1-7 4 decimal 
1044 


This method allows the direct entry of machine codes, a direct command 
for execution, and a way to examine the appropriate memory locations to see 
the results. 

The preparation necessary before entry is a disadvantage. Mnemonic codes 
must be looked up. All branch destinations must be calculated and converted to 
hexadecimal values. All data must be entered in hexadecimal notation also. Re- 
sults, too, are in hexadecimal and must be converted to decimal values to be 
meaningful (unless you have eight fingers on each hand). 

4 5 a P 
‚3 b ; a Ê E 


3 10 


Not many people like to go through all that mathematical calculation, so they 
use an assembler to create machine language programs. 


MULTIPLICATION USING THE MINI-ASSEMBLER 


When using the Mini-Assembler, the programmer need only be concerned 
with the starting address and the mnemonic codes for the instructions. Mne- 
monic codes are much easier to remember than hexadecimal numbers. After 
some use, you will find that you don’t have to look up the codes. Since they 
are abbreviations of actual instruction names, they have some meaning. 
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To access the Mini-Assembler, type: F666G 
*F666G 
1e Assembler responds with its prompt 


Type in the starting address, a colon, and the first mnemonic code. 


*F666G 


1300:LDX #8m 


The Mini-Assembler assembles this instruction and replaces your line with 
the address, Op code, and mnemonic. The cursor moves to the next line, ready 
for the next mnemonic code and any operand. 


*F666G 


0300- LDX #$08 


A2 08 


Continue entering the mnemonic codes with their operands until the pro- 
gram is complete. 


*F666G 


0300- 
0302- 
0304- 
0307- 
0309- 
030C- 
030E- 
0311- 
0314- 
0315- 
0318- 
031B- 
031D- 
031E- 
0321- 
0323- 
0326- 
0327- 
0329- 
032C- 


A2 08 
A9 12 
8D 02 10 
A9 3A 
8D 03 10 
A9 00 
8D 00 10 
8D 01 10 
0A 

2E 00 10 
OE 03 10 
90 09 
18 

6D 02 10 
90 03 
EE 00 10 
CA 

DO EB 
8D 01 10 
60 


LDX #$08 

LDA #$12 

STA $1002 
LDA #$3A 
STA $1003 
LDA #$00 

STA $1000 
STA $1001 

ASL 

ROL $1000 
ASL $1003 
BCC $0326 
CLC 

ADC $1002 
BCC $0326 
INC $1000 

DEX 

BNE $0314 
STA $1001 

RTS 


ени 


* 
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To re-enter Monitor 


To run the program, use the Monitor command: 300G 


To see the result, use the Monitor examine: 1000.1001 


*300G 


*1000.1001 
1000- 04 14 
TUS cime hexadecimal result 


*.g 


Most people working with machine language agree that an assembler re- 
moves much of the drudgery of machine language programming. It cannot 
provide execution of programs, but it takes care of assigning Op codes and the 
operands that go with them. 

The Mini-Assembler does rely on the System Monitor for execution of the 
assembled program and for examination of memory for results (although a dis- 
play of the results could have been included in the program). 

You have seen each of the four methods in action working on the same 
program. Keep in mind that we provided you with the necessary instruction 
codes and data for the program. You should try all four methods on a program 
of your own creation and then decide which method you prefer. 

The combination of the Mini-Assembler and System Monitor is hard to 
beat. The Mini-Assembler does all the detail work, and the Monitor provides the 
execution and debugging capabilities. 


8-BIT DIVISION 


Once again, we'll take a look at pencil-and-paper division before looking 
at the computer's method. Since division is the inverse operation of multiplica- 
tion, we'll use the same numbers that we used in the multiplication example, 
with one exception. That exception is made to the dividend so that the division 
example will not come out even. There will be a remainder. 
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Example: 


1046 (decimal) T 58 (decimal) 
Decimal Binary 
18 quotient 1 0010 quotient 

58)1046 0011 1010) 0100 0001 0110 

58 0011 1010 

466 111 011 

464 111 010 

2 remainder 10 remainder 


1 0010 = 12 HEX = 18 dec. 
It checks —————_—————_» 
10 = 2 HEX = 2 dec. 


Just as in multiplication, you can see shifts being made as the division 
takes place. Place value is very important in this process. Notice that a subtrac- 
tion is made only if the divisor is smaller than part of the dividend that is being 
tested. A 1 then is placed in the quotient. If the divisor is larger, a O is placed in 
the quotient. 

Our machine language program will operate in much the same way. The 
first part of the program places the appropriate values in their respective memo- 
ry locations. The values are stores as follows: 


Memory Address Contents 


accumulator Most Significant Byte of the 
dividend 


1001 Least Significant Byte of 
dividend 


The accumulator and memory location 1001 hold the original dividend. 
Each time through the loop, memory location 1001 is shifted left and the 
accumulator is rotated left. If a carry occurs from memory 1001's shift, it will 
appear as a 1 in the least significant bit of the accumulator when it is rotated. 
If no carry occurs from the memory 1001 shift, a zero appears in the least 
significant bit of the accumulator. Thus, each time through the loop, the divi- 
dend is shifted one place from memory 1001 to the accumulator. This lets the 
computer compare the divisor with the most significant part of the dividend for 
a trial division. 
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The division is accomplished by comparing the divisor with the accumula- 
tor. Every time the divisor is smaller than or equal to the accumulator, the di- 
visor is subtracted from the accumulator, and memory 1001 is incremented by 
one. This means a 1 is appearing in the quotient. 

If the divisor is larger than the accumulator, no subtraction is made, and 
memory 1001 is not incremented. This means a 0 appears in the quotient. 

As the bits in the accumulator and memory 1001 move to the left, the 
quotient appears in memory 1001 from the right (0 if divisor did not go into 
dividend; 1 if divisor did go into dividend). 

After the loop is completed (8 passes through), the remainder is placed in 
memory location 1002. When the program is complete, you'll find the 8-bit quo- 
tient in memory location 1001 and the remainder in memory location 1002. 


DIVISION FLOWCHART 


ENTER 


Housekeeping 


Load X register with 8 

Load accumulator with divisor 

Store it in memory 1000 

Load accumulator with Least 
Significant Byte of dividend 

Store it in memory 1001 

Load accumulator with Most 

Significant Byte of dividend 


Loop 8 times 


Shift memory 1001 left 
Rotate accumulator left 


Will it 
divide 


No 


Yes 


Subtract divisor from accumulator 
Increment memory 1001 (quotient) 


Decrement the X register 


No 


Yes 


Store remainder in 1002 


EXIT 
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The housekeeping chores are similar to those of the multiplication pro- 
gram. 


Mnemonic 


768 0300 162 A2 LDX #08 
769 0301 8 08 

770 0302 169 A9 LDA #3A 
771 0303 58 3A 

772 0304 141 8D STA $1000 
773 0305 0 00 

774 0306 16 10 

775 0307 169 A9 LDA #16 
776 0308 22 16 

777 0309 141 8D STA $1001 
778 030A 1 01 

779 030B 16 10 

780 030C 169 A9 LDA #4 
781 0300 4 04 


The rotate instruction appears in a new form in the loop in this program. 
We are using ROL A to rotate the accumulator. It works the same way as it did 
when we rotated a memory location, but this time the accumulator's contents 
are rotated. The loop is again executed 8 times using the X register as a counter. 


Now, the division section. 
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x 


Memory Address 


OE 


Assembler 
Mnemonic 


ASL $1001 


ROL A 


CMP $1000 


BCC $031D 


SBC $1000 


INC $1001 


DEX 


BNE $030E 


STA $1002 


Take your choice as to how you want to enter and run the program: 
1. BASIC 


2. BASIC Operating System 
3. System Monitor 
4. Assembler 


We'll use the Assembler. 
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*F666G 


This ends the chapter and the explorations of machine language for this 
book. There are many more things for you to try. There are some instructions 
that haven't been covered; but with the knowledge you now have, you will be 
able to dig everything else out by yourself. The complete list of instructions 
is given in Appendix D. They may also be found, along with a description of 
their use, in MCS6500 Microcomputer Family Programming Manual, available 
from MOS Technology, Inc., 950 Rittenhouse Road, Norristown, PA 19401. 


In this chapter you've had a chance to compare four ways to produce a 
machine language program: 


1. Directly from BASIC 


0300- A208 
0302- A93A 
0304- 8р 00 10 
0307- А9 16 
0309- 8р 01 10 
030C- А9 04 
030E- ОЕ 01 10 
0311- 2А 
0312- CD0010 
0315- 9006 
0317- EDO010 
031A- EEO1 10 
031D- CA 
031E- DOEF 
0320- 8D0210 
0323- 60 
I$FF69G 
*300G 
*1001.1002 
1001- 12 MAL 
ОА 
Quotient 


LDX #$08 

LDA #$3A 
STA $1000 
LDA #$16 

STA $1001 
LDA #$04 

ASL $1001 

ROL 

CMP $1000 
BCC $031D 
SBC $1000 
INC $1001 

DEX 

BNE $030E 
STA $1002 
RTS 


Remainder 


SUMMARY 


2. From the BASIC Operating System 
3. From the Apple System Monitor 


4. From the Mini-Assembler 
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Each method has its advantages and disadvantages. Multiplication and division 
examples were used to demonstrate the different methods. 


You learned that 
1. Multiplication of two 8-bit numbers produces a 16-bit product 


2. The computer can multiply by shifting and rotating data and adding the 
multiplicand in a predetermined way 


3. Each of the four methods produces equivalent results 


4. All the methods except the assembler require looking up instructions and/or 
converting numbers from one base to another 


5. The assembler requires the least amount of preparation of the four methods 
— it assembles a machine language program doing all the necessary calcula- 
tions and selecting the Op codes from the mnemonics that you provide 


6. The computer performs division in a similar way to the common paper-and- 
pencil method 


7. Division of a 16-bit dividend by an 8-bit divisor produces an 8-bit quotient 
with a remainder 


New Instructions 


ROL oper — an Absolute Addressed instruction that rotates each bit in the 
specified memory location one place to the left. The Most Significant 
Bit moves into the carry bit, and the carry bit moves into the Least 
Significant Bit of the specified memory. 


ASL oper — an Absolute Addressed instruction that shifts each bit in the spe- 
cified memory location one place to the left. The Most Significant Bit 
moves into the carry bit, and a zero is moved into the Least Significant 
Bit of the specified memory. 


ROL A — rotates the bits in the accumulator one place to the left. The Most 
Significant Bit moves into the carry bit, and the carry bit moves into the 
Least Significant Bit of the accumulator. 


EXERCISES 


1. Name the four methods given for entering machine language programs. 


а. eee 
б. —— ee 
С. ———————————————— 


д.о  —___ —— 


2. Explain what happens in the carry bit following the execution of the ASL A 
instruction. 
The carry Ы 


а 
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10. 


. Explain why the X register was set to 8 at the beginning of the Multiplica- 


tion programs. 


. Given that memory location 1234 contains the following and the carry bit 


is set to one, 


01110101 
C 


memory 1234 
show what each contains after a ROL $1234 instruction is executed. 


JL o 


memory 1234 


. In what memory locations will the product be found in the Multiplication 


from BASIC program? 


(decimal) and (decimal) 


. If a machine language program is 50 bytes long and it is entered by the 


BASIC Operating System, the data is displayed in specific-sized blocks. 
How many blocks of data would be needed to store the 50-byte program? 


. If the Apple System Monitor is used to enter a machine language program, 


what number system(s) (decimal, hexadecimal, or binary) is(are) used to 
enter the program? 


_ 44 


. Explain the results of executing the command *F666G. 


—————————————— ÀÀ 
———————————— ÉL 


. What would be displayed on the screen if the RETURN key were pressed 


following *F666G? 


*F666G 


If you wish to leave the Mini-Assembler and return to the System Monitor, 
what command is typed? 
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11. 


oO ON OO їл 


10. 


11. 


жашын 


What memory location is used to hold the quotient in the Division program? 
(HEX) 


ANSWERS TO EXERCISES 


Directly from BASIC using POKE, CALL, and PEEK 
The BASIC Operating System 

The System Monitor 

d. Тһе Mini-Assembler 


о> >л ы 


‚ The carry bit (original) is lost. It is replaced by the Most Significant Bit 


from the accumulator. 


. The X register is used to count the number of passes through the loop. 


Since we are multiplying by an 8-bit number, there are 8 passes through the 
loop. 


Memory 1234 


Old Carry 


. 4097 and 4096 (Most and Least Significant Bytes, respectively) 
‚ З (The display shows 20 blocks at a time) 

. hexadecimal only 

. The Mini-Assembler is entered from the Monitor 


*F666G 


SiS ү 


Prompt 


1$ FF69G 
1001 (HEX) 
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Appendixes 


Appendix A contains information that has been used in this book with a 
page reference for each item. The page reference gives the location of either 
the first occurrence of the item or an explanation of the item. 

Appendix B contains a table of conversions for negative decimal numbers 
to their hexadecimal equivalents. 

Appendix C is an explanation of the memory map used for the video dis- 
play. Also given are a table of codes used for displaying characters on the screen 
and a table of color codes used for display of graphics. 

Appendix D is a list of 6502 instruction codes. 


APPENDIX A-1 BASIC STATEMENTS 


Statement Statement 
16 


LOAD 
18 LOGIC 
16 MATH 
13 NEW 


NORMAL 
NOTRACE 


DATA 


FLASH ON.GOTO 
FOR-NEXT PDL 
GET PEEK 


PLOT 
POKE 


GOSUB 
GOTO 


GR PRINT 
HLIN READ 
HOME RESTORE 


IF. THEN RETURN 


INPUT 
INT 
INVERSE 
LEFT$ 
LET 
LIST 
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APPENDIX A-2 MACHINE LANGUAGE INSTRUCTIONS 


Mnemonic 
Code 


Addressing 
Mode 


Absolute 
Immediate 
Immediate 
Absolute 
Accumulator 
Relative 
Relative 
Relative 
Relative 
Relative 
Relative 
Implied 
Implied 
Absolute 
Immediate 
Immediate 
Implied 
Implied 
Implied 
Implied 
Implied 
Absolute 
Absolute 
Absolute 
Abs. Ind. 
Immediate 


Mnemonic 
Code 


Addressing 
Mode 


Index. Ind. 
Ind. Index 
Zero Page 
Zero P. Ind. 
Immediate 
Zero Page 
Abs. Index. 
Immediate 
Implied 
Implied 
Implied 
Absolute 
Accumulator 
Implied 
Absolute 
Immediate 
Implied 
Implied 
Absolute 
Abs. Index 
Ind. Index. 
Zero Page 
Zero P. Ind. 
Implied 
Implied 
Implied 


APPENDIX A-3 BUILT-IN SUBROUTINES 


Function Performed 


Plot a point 

Plot a horizontal line 
Plot à vertical line 
Set Graphics Mode 


Clear the screen 

Random number 

Get a keystroke 

Carriage return 

Display accumulator (HEX) 
Display accumulator 

Ring the bell 


LDA C030 is not really a subroutine, but performs like one. It 
tweaks (or toggles) the speaker. 


APPENDIX A-4 DISPLAY SYMBOLS 


Ы System Monitor Prompt — used for machine 
language 

Applesoft 11 prompt — used for Applesoft 11 
BASIC 

Integer BASIC prompt — used for Integer 
BASIC 

Mini-Assembler prompt — used to assemble 
machine language programs 

Cursor — shows next print position to be used 

(blinks normally) 
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APPENDIX A-5 PROGRAMS 


Add Two Decimal Numbers 229-233 
Add Two Decimal Numbers 209 
Add Two Numbers 165 
Automated Scale 253-254 
Automated Scale 134-137 
BASIC Operating System 42-44 
Color Bars 248-249 
Copy Memory Locations 236-239 
Display a Message 118-119 
Display ASCII Codes 109-111 
Display a String of One Letter 97 
Display One Letter 95 
Division 274-276 
Four-Corner Plot 80-81 
Horizontal Line 83 
Indexed Indirect Addressing Demo 245 
Indirect Indexed Addressing Demo 252-253 
Increment the X Register 221 
Load Accumulator and Store 60 
Modified Addition 170 
Multiplication from BASIC 265 
Multiplication from BASIC Op. Sys. 266-267 
Multiplication from Mini-Assembler 270 
Multiplication from System Monitor 268 
Number Guessing Game 191-195 
PEEK and POKE Demonstration 27 
Play Your Own Tune 149-150 
Plot a Point 73 
POKE and PEEK, Then POKE Again 28 
Rectangle Drawing 89-91 
Running Alphabet 107-108 
Scale with Notes 143-146 
Storing Data from Keyboard 240-243 
Subtract Two Numbers 175 
Tone Experiment 126-127 
Two-Byte Addition 182 
Two-Byte Subtraction 184 
Vertical Line 86 


M/L = Machine Language 
A/L = Assembly Language 
BASIC = Applesoft 11 BASIC 
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APPENDIX B HEX EQUIVALENTS FOR DECIMAL NEGATIVES 


APPENDIX C-1 VIDEO MEMORY 


You discovered in Chap. 5 that the top line (or line 1) of the video display 
is associated with memory locations 0400 through 0427 hex. You might suspect 
that the next line would be associated with memory locations 0428 through 
044F, but this is not so. 

If you go back to the CHARACTER DISPLAY PROGRAM in Chap. 4 
and change the instruction at memory locations 775, 776, and 71] to: STA 
0428, the program would store a string of A's in those locations. 


775 99 | STA 0428,Y 
776 28 
777 04 


Here is where the A's would be printed on the display if the program is 
run with these values. 


9th line AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 

If the value stored in memory location 776 is changed to 50, where do you 
think the string of A's would appear? If you said the seventeenth line, you were 
correct. 


17th line ААААААААААААААААААААААААААААААААААА 


So far, we have found lines 1, 9, and 17. 


By this time, you may have guessed what memory locations are associated 
with all 24 lines of the video display. 
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Line 1 
Line 2 
Line 3 
Line 4 
Line 5 
Line 6 
Line 7 
Line 8 
Line 9 
Line 10 
Line 11 
Line 12 
Line 13 
Line 14 
Line 15 
Line 16 
Line 17 
Line 18 
Line 19 
Line 20 
Line 21 
Line 22 
Line 23 
Line 24 
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APPENDIX C-2 ASCII SCREEN CODES 


A0 60 20 


о со з Сул „> оо м о ~: 


„ Vt Awe e 


Char = Character 
Nor. = Normal mode 
Fla. = Flashing mode 
Inv. = Inverse mode 
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| SH KNX KEK CHYAOVOZEZErFA——-TAAMIAAP® 


CO 40 00 


APPENDIX C-3 COLOR CODES FOR LOW RESOLUTION 
GRAPHICS 


Black 
Magenta 
Dark blue 
Light purple 
Dark green 
Grey 
Medium blue 
Light blue 
Brown 
Orange 
Grey 

Pink 

Green 
Yellow 
Blue/green 
White 


0 
1 

2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 


The colors may vary somewhat depending on the settings of your TV set. 
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APPENDIX D 6502 INSTRUCTION CODES 


Mnemonic Addressing Assembler Op No. Flags 
Code Mode Form Code| Bytes| Affected 
ADC Immediate ADC #oper 69 2 NZCV 
Zero Page ADC oper 65 2 
Zero Page,X | ADC oper,X 75 2 
Absolute ADC oper 6D 3 
Absolute,X ADC орег,Х 7D 3 
Absolute, Y ADC oper, Y 79 3 
(Indirect,X) | ADC (oper,X) | 61 2 
(Indirect, Y | ADC (орег),Ү | 71 2 
AND Immediate AND #oper 29 2 NZ 
Zero Page AND oper 25 2 
Zero Page,X | AND oper,X 35 2 
Absolute AND oper 2D 3 
Absolute,X AND oper,X 3D 3 
Absolute, Y AND oper, Y 39 3 
(Indirect,X) | AND (oper,X) | 21 2 
(Indirect), Y | AND (oper), Y | 31 2 
ASL Accumulator | ASL A OA 1 NZC 
Zero Page ASL oper 06 2 
Zero Page,X | ASL oper, X 16 2 
Absolute ASL oper OE 3 
Absolute, X ASL oper, X 1E 3 
BCC Relative BCC oper 90 2 none 
BCS Relative BCS oper BO 2 none 
BEQ Relative BEQ oper FO 2 none 
BIT Zero Page BIT oper 24 2 NZV 
Absolute BIT oper 2C 3 
BMI Relative BMI oper 30 2 none 
BNE Relative BNE oper DO 2 none 
BPL Relative BPL oper 10 2 none 
BRK Implied BRK 00 1 | 
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Mnemonic 
Code 


BVC 


BVS 


CLC 


CLD 


CLI 


CLV 


CMP 


CPX 


CPY 


DEC 


DEX 


DEY 


EOR 


Addressing 


Mode 
Relative 
Relative 
Implied 
Implied 
Implied 
Implied 


Immediate 
Zero Page 
Zero Page,X 
Absolute 
Absolute,X 
Absolute, Y 
(Indirect, X) 
(Indirect), Y 


Immediate 
Zero Page 
Absolute 


Immediate 
Zero Page 
Absolute 


Zero Page 
Zero Page,X 
Absolute 
Absolute,X 


Implied 
Implied 
Immediate 


Zero Page 
Zero Page,X 


Assembler 
Form 


BVC oper 
BVS oper 
CLC 
CLD 

CLI 

CLV 


CMP #oper 
CMP oper 
CMP орег,Х 
CMP oper 
CMP орег,Х 
CMP oper, Y 
CMP (oper,X) 
CMP (oper), Y 


CPX #oper 
CPX oper 
CPX oper 


CPY #oper 
CPY oper 
CPY oper 


DEC oper 
DEC орег,Х 
DEC oper 
DEC орег,Х 
DEX 

DEY 

EOR #oper 


EOR oper 
EOR oper,X 
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Op 
Code 


50 
70 
18 
D8 
58 
B8 


C9 
C5 
05 
CD 
DD 
D9 
C1 
D1 


EO 
E4 
EC 


CO 
C4 
CC 


C6 
D6 
CE 
DE 


CA 
88 
49 


45 
55 


NON C9 W UO DN м — 


W Мм М 


UJ М м 


№. 
Bytes 


Flags 


Affected 


NZC 


NZC 


NZC 


NZ 


NZ 


NZ 


NZ 


Mnemonic 
Code 


INC 


INX 
INY 


JMP 


JSR 


LDA 


LDX 


LDY 


Addressing 


Mode 


Absolute 

Absolute, X 
Absolute, Y 
(Indirect, X) 
(Indirect), Y 


Zero Page 
Zero Page, X 
Absolute 
Absolute, X 


Implied 
Implied 


Absolute 
Indirect 


Absolute 


Immediate 
Zero Page 
Zero Page,X 
Absolute 
Absolute, X 
Absolute, Y 
(Indirect, X) 
(Indirect), Y 


Immediate 
Zero Page 
Zero Page, Y 
Absolute 
Absolute, Y 


Immediate 
Zero Page 
Zero Page,X 
Absolute 
Absolute,X 


Assembler 
Form 


EOR oper 
EOR oper,X 
EOR oper, Y 
EOR (oper,X) 
EOR (oper), Y 


INC oper 
INC oper, X 
INC oper 
INC oper,X 


INX 
INY 


JMP oper 
JMP (oper) 


JSR oper 


LDA £oper 
LDA oper 
LDA oper,X 
LDA oper 
LDA oper,X 
LDA oper, Y 
LDA (oper,X) 
LDA (oper), Y 


LDX #oper 
LDX oper 
LDX oper, Y 
LDX oper 
LDX oper, Y 


LDY #oper 
LDY oper 
LDY oper,X 
LDY oper 
LDY oper,X 


29] 


Op 
Code 


4D 
5D 
59 
41 
51 


E6 
F6 
EE 
FE 


E8 
C8 


4C 
6C 


20 


A9 
А5 
В5 
Ар 
BD 
B9 
Al 
B1 


A2 
A6 
B6 
AE 
BE 


AO 
A4 
B4 
AC 
BC 


No. 
Bytes 


NN WW W 


WW 


ы WN Мм Мм NON W UO W м ND м Wo 


U чо МЮ м Мм 


Flags 


Affected 


NZ 


NZ 


NZ 


none 


none 


NZ 


NZ 


NZ 


Mnemonic 
Code 


LSR 


NOP 


ORA 


PHA 
PHP 
PLA 
PLP 


ROL 


RTI 
RTS 


SBC 


Addressing 


Mode 


Accumulator 
Zero Page 
Zero Page,X 
Absolute 
Absolute,X 


Implied 


Immediate 
Zero Page 
Zero Page,X 
Absolute 
Absolute,X 
Absolute, Y 
(Indirect, X) 
(Indirect), Y 


Implied 
Implied 
Implied 
Implied 
Accumulator 
Zero Page 
Zero Page,X 
Absolute 
Absolute, X 
Implied 
Implied 
Immediate 
Zero Page 


Zero Page,X 
Absolute 


Assembler 
Form 


LSR A 

LSR oper 
LSR oper,X 
LSR oper 
LSR oper, X 


NOP 


ORA #oper 
ORA oper 
ORA oper,X 
ORA oper 
ORA oper,X 
ORA oper, Y 
ORA (oper,X) 
ORA (oper), Y 


PHA 

PHP 

PLA 

PLP 

ROL A 
ROL oper 
ROL oper,X 
ROL oper 
ROL oper,X 
RTI 

RTS 

SBC #oper 
SBC oper 


SBC oper,X 
SBC oper 
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Op 
Code 


4A 
46 
56 
4E 
5E 


EA 


09 
05 
15 
OD 
1D 
19 
01 

11 


48 
08 
68 
28 
2A 
26 
36 
2E 
3E 
40 
60 
E9 
E5 


F5 
ED 


No. 
Bytes 


-— UJ U9 юрю — 


NON WW UO DN DN м 


a= 


W м м м 


Flags 


Affected 


NZC 


none 


NZ 


none 


none 


NZ 


all 


NZC 


all 


none 


NZCV 


Assembler 
Form 


SBC oper,X 

SBC (oper, Y) 
SBC (oper, X) 
SBC (oper), Y 


SEC 


Mnemonic 
Code 


Addressing 
Mode 


Absolute, X 
Absolute, Y 
(Indirect, X) 
(Indirect), Y 


Implied 


Implied SED 


Implied SEI 


Zero Page 
Zero Page,X 
Absolute 
Absolute, X 
Absolute, Y 
(Indirect, X) 
(Indirect), Y 


STA oper 
STA oper, X 
STA oper 
STA oper,X 
STA oper, Y 
STA (oper,X) 
STA (oper), Y 


STX oper 
STX oper, Y 
STX oper 


Zero Page 
Zero Page, Y 
Absolute 


Zero Page 
Zero Page,X 
Absolute 


STY oper 
STY oper, X 
STY oper 


Implied TAX 


Implied TAY 


Implied TYA 


Implied TSX 


Implied TXA 


Implied TXS 
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Op 
Code 


FD 
F9 
E1 
F1 


38 
F8 
78 
85 
95 
8D 
9D 
99 
81 
91 
86 
96 
8E 
84 
94 
8C 
AA 
A8 
98 
BA 
8A 


9A 


No. 
Bytes 


— NN W UO 


MN МЮ W шо м м 


Flags 


Affected 


none 


none 


none 


NZ 


NZ 


NZ 


NZ 


NZ 


none 


Index 


Absolute indexed addressing, 239 
Accumulator, 47, 53 
ADC 
absolute mode, 182 
immediate mode, 164 
Addition, 163, 179-80 
Alter memory, 161 
AND, 152 
Apple languages, 1 
Applesoft II BASIC, 2 
Arithmetic Logic Unit, 68 
ASC, 16 
ASCII Codes, 95, 108, 109-110, 113 
ASL 
Absolute Mode, 262 
Immediate mode, 66 
Assumptions (System), 1 
Asterisk prompt, 1 


BASIC, 1 

Basic Apple Computer, 2 

BASIC Operating System, 25, 29-30, 
41-44 

BCC, 167 

BCS, 167 

BEQ, 119 

Binary numbers, 47-48 

Bits, 23, 46 

Blinking text, 116 

BMI, 156 

BNE, 97 
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BPL, 156 

Branching, 100 
backward, 104 
forward, 102 

Byte, 31, 46 


CALL, 18, 27 

Carriage return, 193 
Carry flag, 167 

Central Processing Unit, 28, 46 
Changing errors, 35 
CHR$, 16 

CLC, 164 

CLD, 209 

Clear Screen, 93 

CMP, 119, 193 
COLOR, 13 

Color Table, 74 
Column for Graphs, 75 
CONT, 5 

Counters, 95 

CPX, 114 

CPY, 97 

Cursor, 1 


DATA, 7 

Data block move, 210 
Data block verify, 212 
Decimal arithmetic, 208 
Decimal flag, 209 

DEX, 128 


DEY, 128 

Display a character, 111 
Display two HEX digits, 111 
Dividend, 270 

Divisor, 271 


Errors, 35 

Examine memory, 161 

Executing machine language 
programs, 163 


Firmware ROM, 2 
FLASH, 10 
FOR-NEXT, 12 
Four-Corner Plot, 80 


GET, 8, 62 

Get a keystroke, 111 
GOSUB, 12-13 

GOTO, 11 

GRaphics, 4 

Graphics and sound, 146 


Hexadecimal, 29, 32, 37-38 
Hexadecimal addition, 203 
Hexadecimal digit, 39, 48 
Hexadecimal subtraction, 206-7 
HLIN, 14 

HOME, 10 

Horizontal Lines, 83-84 


IF-THEN, 12 

INC, 171 

Index, 95 

Indexed Addressing, 234 
Indexed Indirect, 244 
Indirect Indexed, 251 

Index Register, 75 

INPUT, 6-7 

Instruction decoder, 47 

INVERSE, 10 

Inverse Text, 115 

INX, 107 

INY, 97 


JMP, 118 
JSR, 72 


LDA 
absolute, 171 
Absolute Indexed, 240 
C030, 128 
immediate, 58 
Indexed Indirect, 244 
zero page, 191 
Zero Page Indexed, 235 
LDX 
absolute, 128 
immediate, 107 
LDY 


absolute, 142 
immediate, 93 
Least significant bit, 52 
Least Significant Byte, 52 
LEFT$, 16 
LET, 6 
LIST, 3 
LOAD, 5 
Loop, 11 


Machine language, 22, 28-29 
Memory, assigned, 57 
Memory map, 26 
Mini-Assembler, 227 
Mnemonic code, 58, 227 
Monitor, 160 

Most significant bit, 52 

Most Significant Byte, 52 
Move data block, 210 
Multiple-byte arithmetic, 179-80 
Multiplicand, 260 
Multiplication, 259-60 
Multiplier, 260 


Negative numbers, 186-89 
NEW, 3 

NOP, 154-55 

NORMAL, 10 
NOTRACE, 6 
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One's complement, 173 
ON-GOTO, 11-12 

Op Code, 58 

Operating system, 25 
Order of Operations, 16 


PDL, 14 

PEEK, 19, 24-25 
PHA, 133 

Pitch for Sound, 131 
PLA, 134 

PLOT, 13 

Plot a Point, 73 
Plug-in ROM card, 2 
POKE, 17-18, 24 
PRINT, 8-10 


Processor status register, 166 


Quotient, 272 


Random number, 191 
READ, 7 
Rectangles, 89-92 
Registers, 214 
Relationships, 15 
Remainder, 12-17 
RESTORE, 8 
RETURN, 13 
Ring bell, 193 
ROL 
absolute mode, 262 
accumulator, 273 
ROM, 1 
Row for Graphics, 75 
RTS, 59 


SAVE, 5 
SBC, 174, 184 


SEC, 174 
SED, 209 
Single step, 217 
SPC, 11 
STA 
absolute, 59 
Absolute Indexed, 97, 239 
Indirect Indexed, 247 
Zero Page, 92 
Zero Page Indexed, 235 
Stack, 133 
Starting address, 31 
Status flags, 164-65 
Subroutine, 27-28 
Subtraction, 172, 184 
System monitor, 160 


TAX, 132 

TAY, 220-21 

TEXT, 4, 14-15 

TRACE, 6 

Tweak speaker, 125 

Two-byte addition, 179-84 
Two-byte subtraction, 184-86 
Two's complement, 173 
TXA, 132 


Verify data blocks, 212 
Vertical Lines, 86-89 
VLIN, 14 

X register, 106 


Y register, 98 


Zero Page Indexed Addressing, 234 


Zero Page instructions, 73 
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APPLE 
MACHINE LANGUAGE 
DON INMPIN/ KURT INMAN 


Learn machine language programming in practically no time at all! It’s 
easy with this ALL NEW guide to the Apple computer! 


If you already know BASIC and have access to one of the popular 
Apple models, you're on your way to developing real expertise on the 
subject. The book combines color, graphics, and sound with clear-cut 
demonstrations to help you learn—FAST! 


You'll start off simply, using BASIC statements like POKE, PEEK, and 
CALL to enter and execute machine language programs. Then you'll 
develop a BASIC Operating System, entering and executing your ma- 
chine language programs from there. The next step will have you using 
an Apple System Monitor to program directly and save the time usually 
needed to interpret BASIC statements. 


Finally, you'll learn how to use the Apple Mini-Assembler to avoid the 
troublesome .details involved with direct machine language program- 
ming. All in a few, quick stages—you'll be surprised at how uncompli- 
cated it is! 


So, whether you're interested in sharpening your present skills for pro- 
fessional reasons, or you just want to get the most out of your personal 
computer system, this unique guidebook is your key to exciting, new 
levels of computer technology! 


RESTON PUBLISHING COMPANY, INC. | 2189802 304 
A Prentice-Hall Company 


Reston, Virginia 0-8359-0230-7 


